Erreurs
Tous les refus ont la même forme. Basez-vous sur code : il ne change jamais. message s’adresse à une personne, et peut changer.
La forme d’une erreur
{
"error": {
"code": "insufficient_balance",
"message": "This file costs $18.00 USD but your balance is $4.50 USD. Please add funds.",
"request_id": "req_7f3c9a12",
"docs_url": "https://docs.talismanleads.io/errors#insufficient_balance"
}
}Indiquez le request_id si vous contactez l’assistance. Chaque réponse le contient aussi dans l’en-tête Request-Id.
Tous les codes
L’API ne comprend pas la requête : le message indique pourquoi. Corrigez-la avant de la renvoyer.
POST /orders exige un en-tête Idempotency-Key valide : jusqu’à 200 caractères ASCII sans espaces.Une ligne de la liste n’est pas ce que le vérificateur accepte. Le message montre des exemples.
Ce vérificateur exige plus d’entrées par fichier.
La liste est trop longue : jusqu’à 100 000 entrées dans une requête, ou 10 000 000 dans une importation.
Le fichier dépasse 200 MB.
Le
country que vous avez envoyé ne correspond pas aux numéros de la liste.Un fichier doit contenir des numéros d’un seul pays. Divisez-le en un fichier par pays.
Ce
upload_id n’est pas l’un des vôtres, son fichier n’a pas fini d’être importé, ou son fichier n’existe plus (une importation attend une commande pendant 24 heures). Si vous avez déjà passé une commande à partir de cette importation et perdu la réponse, répétez cette requête avec sa clé d’idempotence d’origine. Sinon, importez à nouveau le fichier et passez la commande avec une nouvelle clé d’idempotence : rien n’a été passé avec l’ancienne.Le fichier a changé après le calcul du prix. Aucune commande n’a été passée. Importez-le à nouveau et passez la commande avec une nouvelle clé d’idempotence.
Le prix est trop ancien pour être utilisé. Répétez la requête avec la même
Idempotency-Key.invalid_key
401La clé API est absente, incorrecte ou n’est pas l’une des nôtres.
revoked_key
401Cette clé API a été révoquée. Utilisez-en une autre.
expired_key
401Cette clé API a expiré. Créez-en une nouvelle.
Votre solde est insuffisant pour cette commande. Rechargez-le, puis répétez la commande avec la même clé d’idempotence.
key_blocked
403Cette clé API a été bloquée. Contactez l’assistance.
Cette clé API est limitée à d’autres adresses IP.
Ce compte ne peut pas utiliser l’API. Contactez l’assistance.
L’accès à l’API est désactivé pour ce compte. Le site fonctionne toujours. Contactez l’assistance.
Cette clé API est en lecture seule, et cet appel exige une clé autorisée à passer des commandes.
Ce vérificateur n’est pas ouvert à votre compte pour le moment. Voir
GET /checkers.Votre adresse IP a été bloquée. Contactez l’assistance.
not_found
404Cette commande ou ce point de terminaison n’existe pas sur ce compte.
Cette clé d’idempotence a été utilisée avec une requête différente. Utilisez une nouvelle clé d’idempotence pour une nouvelle commande.
Le prix n’est pas celui que vous attendiez, ou a changé depuis le premier envoi de la clé d’idempotence. Aucune commande n’a été passée. Utilisez une nouvelle clé d’idempotence pour commander au nouveau prix.
La requête dépasse 4 MB. Utilisez
POST /uploads pour une grande liste.Vous avez trop d’importations en attente (20 fichiers ou 100 MB), ou vous en avez fait trop aujourd’hui (500). Passez une commande à partir de l’une d’elles, ou réessayez plus tard : une importation est supprimée après 24 heures.
rate_limited
429Vous dépassez une limite de requêtes. Attendez le nombre de secondes indiqué dans
Retry-After. Pour une commande, répétez-la avec la même clé d’idempotence. Voir Limites de requêtes.Vous avez trop de commandes non terminées. Attendez le nombre de secondes indiqué dans
Retry-After, puis répétez la commande avec la même clé d’idempotence.Un problème est survenu de notre côté. Sur
POST /orders, la commande a pu aboutir : répétez donc la requête avec la même Idempotency-Key, cela ne débite jamais deux fois. Sur tout autre appel, réessayez ou contactez l’assistance en indiquant le request_id.api_disabled
503L’API est désactivée pour le moment. Réessayez plus tard. Pour une commande, répétez-la avec la même clé d’idempotence.
L’API ne peut pas répondre pour le moment. Attendez une minute et répétez la requête avec la même clé d’idempotence.
Nous n’avons pas pu confirmer la commande. Répétez la requête avec la même
Idempotency-Key pour connaître son état réel : cela ne débite jamais deux fois. Si cette réponse persiste pendant plus de quelques minutes, arrêtez et contactez l’assistance en indiquant le request_id. Ne créez pas de nouvelle clé d’idempotence.