EN IT ES DE FR
link-to@console:~$
POST https://link-to.site/create

// INTRODUCTION

L'API Link-To vous permet de créer des URLs raccourcies de manière programmatique. Notre API est RESTful, retourne des réponses JSON et utilise les codes de réponse HTTP standard. Cette documentation fournit toutes les informations nécessaires pour intégrer notre service de raccourcissement d'URLs dans vos applications.

URL de Base : https://link-to.site

// SPÉCIFICATIONS API

Téléchargez nos spécifications API lisibles par machine pour l'intégration avec des outils comme Postman, Swagger UI ou des générateurs SDK automatisés.

Télécharger OpenAPI 3.0 (JSON)
Télécharger Swagger Spec (YAML)

// AUTHENTIFICATION

Toutes les requêtes API nécessitent une authentification avec votre clé API. Vous pouvez obtenir votre clé API depuis votre tableau de bord après avoir souscrit à un plan avec accès API.

$ obtenir_cle_api()

  1. Connectez-vous à votre tableau de bord
  2. Naviguez vers Paramètres du Compte
  3. Votre clé API sera affichée dans la section Accès API
  4. Copiez votre clé API et gardez-la en sécurité
Gardez votre clé API en sécurité ! Ne la partagez jamais publiquement et ne la commitez pas dans le contrôle de version.

$ methodes_authentification()

Nous supportons deux méthodes d'authentification pour la rétrocompatibilité :

Méthode 1 : Authentification par Header (Recommandé)

HTTP Headers
X-API-Key: votre_cle_api_ici
Content-Type: application/json

Méthode 2 : Paramètre POST (Legacy)

Form Data
apikey=votre_cle_api_ici&url=https://exemple.fr

// PARAMÈTRES DE REQUÊTE

ParamètreTypeRequisDescription
urlstringObligatoireL'URL longue à raccourcir. Doit être une URL HTTP/HTTPS valide.
groupstringOptionnelID de groupe ou identifiant API pour organiser vos liens.

// EXEMPLES DE CODE

$ curl_moderne()

bash
curl -X POST https://link-to.site/create \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: votre_cle_api_ici' \
  -d '{
    "url": "https://exemple.fr"
  }'

$ php_exemple()

php
<?php
$apiUrl = 'https://link-to.site/create';
$apiKey = 'votre_cle_api_ici';

$data = json_encode(['url' => 'https://exemple.fr']);

$options = [
    'http' => [
        'method' => 'POST',
        'header' => [
            'Content-Type: application/json',
            'X-API-Key: ' . $apiKey
        ],
        'content' => $data
    ]
];

$context = stream_context_create($options);
$response = file_get_contents($apiUrl, false, $context);
$result = json_decode($response, true);

if ($result['success'] === 'true') {
    echo "URL Courte : " . $result['short_url'];
} else {
    echo "Erreur : " . $result['message'];
}
?>

$ javascript_exemple()

javascript
const apiUrl = 'https://link-to.site/create';
const apiKey = 'votre_cle_api_ici';

const data = { url: 'https://exemple.fr' };

fetch(apiUrl, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Key': apiKey
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
    if (result.success === 'true') {
        console.log('URL Courte :', result.short_url);
    } else {
        console.error('Erreur :', result.message);
    }
})
.catch(error => console.error('Requête échouée :', error));

$ python_exemple()

python
import requests

api_url = 'https://link-to.site/create'
api_key = 'votre_cle_api_ici'

data = {'url': 'https://exemple.fr'}
headers = {
    'Content-Type': 'application/json',
    'X-API-Key': api_key
}

response = requests.post(api_url, json=data, headers=headers)
result = response.json()

if result['success'] == 'true':
    print(f"URL Courte : {result['short_url']}")
else:
    print(f"Erreur : {result['message']}")

// FORMAT DE RÉPONSE

Réponse Réussie

json
{
    "success": "true",
    "timestamps": "2025/11/13 16:53:37",
    "message": "Certification terminée",
    "error": "",
    "short_code": "abc123",
    "short_url": "https://link-to.site/abc123",
    "long_url": "https://exemple.fr",
    "qr_code": "https://link-to.site/qrcode/abc123.png",
    "title": "Exemple Domaine",
    "clicks": 0
}

Réponse d'Erreur

json
{
    "success": "false",
    "timestamps": "2025/11/13 16:53:37",
    "message": "Clé API non détectée",
    "error": "301"
}

// CODES D'ERREUR

L'API utilise les codes d'erreur suivants pour indiquer des problèmes spécifiques :

CodeDescription
300API mal interrogée - Format de requête invalide
301Clé API non détectée - Authentification manquante
302URL non trouvée - Paramètre 'url' requis manquant
303Utilisateur non trouvé ou mauvaise clé API - Identifiants invalides
304Les URLs raccourcissables sont épuisées - Aucun slot disponible
305L'URL indiquée a déjà été raccourcie
306L'URL n'a pas pu être traitée - Erreur de connexion
307Erreur 404 - La page n'existe pas
308La page est hébergée sur un serveur avec Mod_Security activé
309La page est hébergée sur un serveur sécurisé avec protection Cloudflare
310L'URL mène à un réseau social - Non autorisé
311Les headers HTTP ont retourné 0 comme taille de fichier - Réponse vide
312Le groupe indiqué n'existe pas
429Limite de requêtes dépassée - Réessayez plus tard

// LIMITATION DE DÉBIT

Pour garantir une utilisation équitable et la stabilité du système, les requêtes API sont limitées :

Limite : 1 000 requêtes par heure par clé API

Si vous dépassez la limite, vous recevrez une erreur 429. La limite se réinitialise chaque heure. Si vous avez besoin de limites plus élevées, contactez le support.

// BONNES PRATIQUES

  • Sécurisez votre clé API : Ne l'exposez jamais dans du code côté client ou des dépôts publics
  • Gérez les erreurs correctement : Vérifiez toujours le champ success et gérez les erreurs de manière appropriée
  • Mettez en cache les réponses : Stockez les URLs raccourcies pour éviter les appels API en double
  • Respectez les limites : Implémentez un backoff exponentiel si vous atteignez les limites
  • Validez les URLs : Assurez-vous que les URLs sont valides avant de les envoyer à l'API

// SUPPORT

Besoin d'aide ? Nous sommes là pour vous assister :