Documentation API

Intégrez le raccourcisseur d'URL ly1.ru dans vos applications avec notre simple API REST.

🔐 Authentification requise

L'accès API nécessite une authentification. Connectez-vous avec Google pour obtenir votre clé API. Se connecter

Authentification

Toutes les requêtes API nécessitent une authentification avec votre clé API. Incluez-la dans l'en-tête:

Authorization: Bearer YOUR_API_KEY

Ou utilisez l'en-tête X-API-Key :

X-API-Key: YOUR_API_KEY

Points de terminaison

POST /api/v1/shorten

Créer une URL raccourcie.

Paramètres de requête

Paramètre	Type	Description
url requis	string	L'URL à raccourcir (doit être une URL HTTP/HTTPS valide)
custom optionnel	string	Alias personnalisé (3-32 caractères alphanumériques)

Exemple de requête

# Using curl
curl -X POST https://ly1.ru/api/v1/shorten \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/very/long/url", "custom": "mylink"}'

# Using PHP
$ch = curl_init('https://ly1.ru/api/v1/shorten');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'url' => 'https://example.com/very/long/url',
        'custom' => 'mylink'
    ])
]);
$response = json_decode(curl_exec($ch), true);

Réponse réussie (200)

{
  "success": true,
  "data": {
    "code": "mylink",
    "short_url": "https://ly1.ru/mylink",
    "subdomain_url": "https://mylink.ly1.ru",
    "original_url": "https://example.com/very/long/url"
  }
}

Réponse d'erreur (400/401)

{
  "success": false,
  "error": "Error message here"
}

Codes d'erreur

Code	Description
`400`	Mauvaise requête — Paramètres ou URL invalides
`401`	Non autorisé — Clé API invalide ou manquante
`405`	Méthode non autorisée — Utilisez POST
`500`	Erreur interne du serveur

Limites de débit

Actuellement, il n'y a pas de limites strictes, mais soyez raisonnable. Des requêtes excessives peuvent entraîner un blocage temporaire.