API.

Intégrez le raccourcissement de liens dans vos propres applications.

API disponible — JSON, sans authentification

POST /api/v1/links

Crée un lien court à partir d'une URL longue, avec options de sécurité facultatives.

Requête

curl -X POST https://sdn.ac/api/v1/links \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://exemple.com/un/lien/tres/long",
    "expiration": "7d",
    "burn_after_redirect": false,
    "password": "optionnel"
  }'

Réponse

{
  "code": "7Hk2Qx",
  "short_url": "https://sdn.ac/7Hk2Qx",
  "original_url": "https://exemple.com/un/lien/tres/long",
  "expires_at": "2026-06-26T22:15:00+02:00",
  "burn_after_redirect": false,
  "password_protected": true
}

Paramètres optionnels

expiration : never, 24h, 7d, 30d ou custom.
custom_expires_at : date ISO ou compatible PHP lorsque expiration vaut custom.
burn_after_redirect : supprime le lien après la première redirection réussie.
password : protège l’accès au lien court par mot de passe.

GET /api/v1/links/{code}

Renvoie les informations d'un lien court (URL d'origine si le lien n'est pas protégé, nombre de visites et options actives).

{
  "code": "7Hk2Qx",
  "original_url": "https://exemple.com/un/lien/tres/long",
  "visits": 42,
  "expires_at": "2026-06-26T22:15:00+02:00",
  "burn_after_redirect": false,
  "password_protected": false
}

Pour un lien protégé par mot de passe, original_url n’est pas renvoyée par l’API de lecture.

Limites & garde-fous

Création limitée à 10/min, 100/h et 500/jour par adresse IP. Au-delà : réponse 429 Too Many Requests.
Déduplication : raccourcir une URL déjà connue renvoie le lien existant (pas de doublon).
Les liens avec expiration, mot de passe ou usage unique créent toujours un nouveau code pour ne jamais modifier un lien déjà partagé.
Chaque URL est validée (format, protocole, extensions) et analysée (réputation) avant création.

Une question sur l'API ? Contactez-nous.