Développeurs
Soumettre une tâche API client
Clés, idempotence, plafonds et pagination des résultats.
Utiliser une clé à portée limitée
Utilisez une clé Live avec la portée submit pour les vérifications en production. Conservez-la sur votre serveur et n’attribuez que les portées submit, read ou balance dont vous avez besoin. Les clés Test simulent des adresses d’exemple réservées, sans appel au fournisseur ni consommation de crédits.
Le plafond de la clé Live comptabilise les crédits débités ainsi que les réservations acceptées. Si le plafond est atteint, toute nouvelle tâche est refusée sans création de réservation. Les crédits de l’espace de travail sont réservés à mesure que les vérifications sont admises au traitement, selon les mêmes règles de débit et de restitution que le tableau de bord.
Nouvelles tentatives sécurisées
Envoyez une Idempotency-Key stable avec chaque tâche. Une nouvelle tentative correspondante renvoie la même tâche. Utilisez l’ID de tâche renvoyé pour consulter son état et ses résultats paginés. Une clé réutilisée avec une charge utile différente est rejetée.
Une pause opérationnelle peut temporairement refuser les nouvelles tâches en direct avec l’erreur HTTP 503 live_verification_unavailable, sans réservation de crédit. Réessayez plus tard avec la même clé d’idempotence. Ce mécanisme est distinct des autorisations de clé API, des plafonds de clé et des limites de débit.
Besoin d’aide supplémentaire ?
Connectez-vous pour ouvrir un ticket d’assistance privé.
Contacter l’assistance