API raccourcisseur d'URL : intégrez URLW dans vos applications

L'API REST URLW vous permet d'intégrer la création, la gestion et l'analyse de liens courts directement dans vos applications, scripts ou workflows automatisés. Que vous construisiez un CRM, une plateforme d'emailing ou un outil interne, l'API URLW s'intègre en quelques lignes de code.

Authentification par clé API

Toutes les requêtes à l'API URLW doivent être authentifiées via une clé API transmise dans l'en-tête Authorization. Pour obtenir votre clé :

1. Connectez-vous à votre compte URLW
2. Accédez à Paramètres → API
3. Cliquez sur « Générer une nouvelle clé API »
4. Copiez et conservez cette clé en lieu sûr — elle ne sera affichée qu'une seule fois

Transmettez votre clé dans chaque requête via l'en-tête HTTP :

Authorization: Bearer VOTRE_CLE_API

Ne jamais exposer votre clé API dans du code côté client (JavaScript front-end, applications mobiles). Utilisez toujours un backend intermédiaire pour les appels API.

Premiers pas : raccourcir une URL avec curl

Voici comment créer votre premier lien court via l'API URLW avec la commande curl :

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://exemple.com/ma-tres-longue-url-de-destination",
"slug": "mon-lien",
"domain": "go.votre-marque.fr"
}'

Réponse en cas de succès (HTTP 201) :

{
"id": "lnk_abc123",
"short_url": "https://go.votre-marque.fr/mon-lien",
"original_url": "https://exemple.com/ma-tres-longue-url-de-destination",
"slug": "mon-lien",
"clicks": 0,
"created_at": "2025-06-01T10:00:00Z"
}

Endpoints principaux de l'API URLW

L'API URLW expose les endpoints REST suivants :

• POST /api/v1/links — Créer un nouveau lien court
• GET /api/v1/links — Lister vos liens (avec pagination)
• GET /api/v1/links/{id} — Récupérer un lien par son identifiant
• PATCH /api/v1/links/{id} — Modifier un lien existant (URL de destination, slug, expiration)
• DELETE /api/v1/links/{id} — Supprimer un lien
• GET /api/v1/links/{id}/stats — Obtenir les statistiques de clic d'un lien
• POST /api/v1/links/batch — Créer plusieurs liens en une seule requête

La documentation complète, avec les paramètres, les codes de réponse et des exemples pour chaque endpoint, est disponible sur /docs.

Limites de taux et bonnes pratiques

Pour garantir la qualité de service pour tous les utilisateurs, l'API URLW applique des limites de taux (rate limits) selon votre plan :

• Plan Starter : 60 requêtes par minute
• Plan Pro : 300 requêtes par minute
• Plan Business : 1 000 requêtes par minute

Lorsque vous dépassez la limite, l'API retourne une réponse HTTP 429 Too Many Requests avec un en-tête Retry-After indiquant le délai d'attente. Implémentez un mécanisme de retry avec backoff exponentiel dans vos applications.

Bonnes pratiques pour une intégration robuste :

• Utilisez l'endpoint batch pour créer plusieurs liens en une seule requête plutôt que de multiplier les appels individuels
• Mettez en cache les réponses de l'API côté application pour éviter de requêter à chaque affichage
• Gérez systématiquement les codes d'erreur HTTP (400, 401, 404, 422, 429, 500) dans votre code
• Utilisez les webhooks URLW pour recevoir des notifications sur les événements (clic, expiration) plutôt que de poller l'API

Pour commencer à utiliser l'API, créez votre compte URLW et consultez la documentation API complète.