À propos de cette vidéo

Les réponses de cette vidéo sont de vraies réponses d'API, abrégées. Les clés API, la vérification en masse et celle de fichiers nécessitent un compte payant.

Transcription de la vidéo

1. 00:00Votre première requête

   Votre première requête est un POST vers /verify/single. Envoyez un champ JSON, email. Placez votre clé API dans l'en-tête BV-API-KEY. C'est toute la requête. Gardez cette clé dans une variable d'environnement sur votre serveur, jamais dans du code client. Créer une clé nécessite un compte payant, et tout achat de crédits le débloque.

2. 00:24Lire la réponse

   Voici la vraie réponse pour une adresse de support. Commencez par status. Il indique role, car support est le nom d'une boîte partagée, pas d'une personne. Le score est de 0,6. C'est une valeur issue de règles fixes, pas une probabilité. Raisonnez donc sur status, pas sur le score. is_deliverable vaut true, le serveur de messagerie a donc accepté cette adresse. is_catch_all vaut aussi true, ce domaine accepte donc n'importe quelle adresse. Role prend le statut, et les indicateurs montrent le reste. reason donne le pourquoi, sous forme de code. Ici, c'est catch-all deliverable.

3. 01:02Pourquoi credits_used vaut 0

   La documentation a une page qui liste chaque code. Voyons credits_used. Ici, c'est zéro, mais cela ne veut pas dire que les vérifications sont gratuites. Ce compte a déjà vérifié cette adresse dans les dernières 24 heures, la répétition n'a donc pas été facturée. Une première vérification comme celle-ci coûte un crédit. verification_mode indique d'où vient la réponse. Celle-ci vient de l'historique en cache. Servez-vous-en pour comprendre le résultat. Pour la facturation, lisez credits_used.

4. 01:23Jusqu'à 50 adresses

   Une courte liste ? Utilisez /verify/bulk. L'en-tête reste le même, et le corps prend un tableau emails, jusqu'à 50 adresses. Les résultats reviennent dans cette même réponse. Chaque adresse reçoit les mêmes champs que vous venez de voir. La première est catch-all. La deuxième est invalide, car cette boîte n'existe pas. La troisième est jetable. Les trois ont utilisé un crédit. L'invalide compte. La jetable compte ici parce que cette requête a mis check_smtp à true. Sans cela, une correspondance jetable s'arrête tôt, sans frais. Par défaut, inconnu, syntaxe incorrecte et jetable ne coûtent donc rien. Tout le reste coûte un crédit, catch-all et rôle compris. Sous les résultats, vous trouvez des totaux. Les e-mails valides sont à zéro, car le catch-all n'est pas compté comme valide. Et les groupes classent le lot : un utilisable avec catch-all, deux non délivrables. Au-delà de 50, vous obtenez une erreur HTTP 400 avec le code 3103. La liste n'est pas découpée pour vous, et ne devient pas une tâche de fichier. L'erreur vous renvoie vers l'endpoint de fichiers.

5. 02:28Listes plus grandes

   Pour les listes plus grandes, importez un fichier. C'est asynchrone, l'import vous donne donc un ID de tâche. Utilisez cet ID pour suivre l'avancement. Quand la tâche est terminée, téléchargez les résultats. Gardez l'option -L, car le téléchargement peut rediriger. Le téléchargement est un CSV. Vos colonnes d'origine restent, et de nouvelles suivent, comme ev_status et ev_reason.

6. 02:49Vérifier vos crédits

   /credits vous indique ce qu'il reste. C'est un GET, avec le même en-tête. Consultez-le avant un gros import, car sans assez de crédits, l'API renvoie un 402.

7. 03:00Deux options de requête

   Deux options changent ce que fait une vérification. SMTP est activé par défaut, et aucun e-mail n'est jamais envoyé. check_smtp false saute le serveur de messagerie, la plupart des adresses reviennent donc inconnues. force_refresh true saute le cache, et vous payez le nouveau résultat.

8. 03:17Erreurs et limites

   Gérez d'abord trois erreurs. 401, c'est une clé absente ou invalide. 402 signifie crédits insuffisants. 429 est une limite de débit, patientez donc un instant et réessayez. Les limites de débit s'appliquent par clé API. 6 000 requêtes par minute sur single. 1 500 sur bulk.

9. 03:37Étapes suivantes

   300 sur les imports de fichiers. Voilà le démarrage rapide. Single, bulk, fichier et crédits. La référence complète de l'API, les SDK et les webhooks sont sur billionverify.com/docs. 20 crédits gratuits chaque jour où vous utilisez votre compte, jusqu'à 600 par mois. Aucune carte bancaire requise. Commencez sur billionverify.com.

Présenté dans cette vidéo