POST /api/v1/links/bulk
Envoyez un tableau items ou links de 100 entrées maximum.
Guide développeur
Créez des liens courts en lot avec l’API tt.vg
Utilisez le point de terminaison de production, gérez les succès partiels, réutilisez les clés d’idempotence et branchez les Webhooks.
links:bulk:create
La clé API doit inclure l’autorisation de création en lot.
Idempotency-Key
Réutilisez le même UUID pour reprendre le même lot sans doublon ni nouveau débit de quota.
Copiez et adaptez
Exemples curl, JavaScript et Python
Remplacez la clé API et les destinations. Chaque élément accepte les champs de l’API unitaire.
curl -X POST https://tt.vg/api/v1/links/bulk \
-H "Authorization: Bearer ttvg_your_api_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
-d '{
"items": [
{ "destinationUrl": "https://example.com/a", "description": "Campaign A" },
{ "destinationUrl": "https://example.com/b", "key": "campaign-b" }
]
}'Gestion des réponses
Traitez chaque résultat séparément
Un lot peut contenir des liens créés et des erreurs. Enregistrez l’index renvoyé avec votre entrée.
Tout a réussi
Lisez items et summary ; errors est vide.
Succès partiel
Conservez les éléments réussis et ne reprenez que les entrées en erreur.
Erreur de requête ou d’accès
Corrigez validation, authentification, vérification e-mail ou portée avant de reprendre.
Quota ou limite de débit
Arrêtez le lot et attendez ; respectez Retry-After lorsqu’il est présent.
Erreur temporaire du serveur
Réessayez avec un délai exponentiel et la même Idempotency-Key.
Quotas et taille des lots
Une requête accepte 100 liens maximum. Chaque création réussie consomme une unité quotidienne links:create du forfait ; les échecs ne comptent pas.
Poursuivez avec les Webhooks
Abonnez-vous à link.created, link.updated ou link.clicked. Les envois signés sont asynchrones et repris sans bloquer l’API.
Questions fréquentes
Questions sur l’API en lot
La création en lot est-elle atomique ?
Non. Des éléments valides peuvent réussir tandis que d’autres renvoient des erreurs indexées ; le statut est alors 207.
Que se passe-t-il si le quota s’épuise en cours de lot ?
L’élément courant et les suivants reçoivent une erreur 429, puis le traitement s’arrête.
Comment éviter les doublons lors d’une reprise ?
Envoyez une Idempotency-Key aléatoire et réutilisez-la uniquement pour le même lot.