Documentation API

Utilisez l'API ZIPN pour raccourcir les URL par programmation.

Aperçu

Raccourcir une URL

POST /api/v1/shorten

Paramètres de la requête :

ParamètreObligatoireDescriptif
original_url✅URL d'origine à raccourcir
custom_code❌Code court personnalisé (généré automatiquement en cas d'omission)
expire_duration❌Expiration : 24h, 48h, 1week, 1month

Exemple de demande :

curl -X POST https://zipn.app/api/v1/shorten \
  -H "Content-Type: application/json" \
  -d '{
    "original_url": "https://example.com/very-long-url",
    "custom_code": "example",
    "expire_duration": "1week"
  }'

Réponse réussie (201) :

{
  "status": "success",
  "message": "URL shortened successfully.",
  "data": {
    "short_url": "https://zipn.app/example/",
    "original_url": "https://example.com/very-long-url",
    "code": "example",
    "expiration_date": "2026-04-21T10:00:00.000Z"
  }
}

Réponse d'erreur :

{
  "status": "error",
  "message": "This short code is already in use."
}

Obtenir des informations sur l'API

GET /api/v1/shorten

Renvoie les informations sur le point de terminaison et les paramètres disponibles.