Documentation API
Utilisez l'API ZIPN pour raccourcir les URL par programmation.
Aperçu
- Base URL:
https://zipn.app/api/v1/shorten - Format : JSON
- Authentification : Actuellement disponible sans authentification
Raccourcir une URL
POST /api/v1/shorten
Paramètres de la requête :
| Paramètre | Obligatoire | Descriptif |
|---|---|---|
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.