À propos de cette vidéo

Les réponses de cette vidéo sont de vraies réponses de l'API, raccourcies. Les clés API et la vérification de fichiers nécessitent un compte payant.

Transcription de la vidéo

1. 00:00Importer le fichier

   Importez un CSV vers /verify/file, puis laissez un webhook vous dire quand c'est terminé. Bulk s'arrête à 50 adresses. Pour plus grand, envoyez le fichier entier en données de formulaire multipart. CSV, TXT et XLSX sont acceptés. email_column nomme la colonne à lire. Omettez-la, et elle est détectée pour vous. Voici le fichier de test. Quatre lignes, plus une colonne source que nous voulons garder dans les résultats. L'import n'attend pas les contrôles. Il répond avec un ID de tâche et un statut pending. Il vous dit aussi quelle colonne il a lue, et combien de lignes et d'adresses uniques il a trouvées. Comme la clé API elle-même, les tâches de fichier sont réservées aux comptes payants.

2. 00:43Suivre la tâche

   Pour la suivre, faites un GET sur le même chemin en ajoutant l'ID de tâche. Même en-tête, pas de corps. Interrogé tout de suite, ce petit fichier en était déjà à merging. Pendant l'exécution, le statut passe par des étapes comme preparing, pending, processing et merging. Arrêtez d'interroger dès que vous voyez completed, completed with warning, failed ou cancelled. Voici la tâche terminée. Les compteurs répartissent le fichier par statut : une invalide, une de rôle, une catch-all et une jetable. credits_used vaut un, et cache_hit_not_charged vaut trois. Trois lignes étaient des revérifications. Ces adresses ont été contrôlées sur ce compte dans les dernières 24 heures, et une revérification dans les 24 heures n'est pas facturée. Deux liens l'accompagnent. download_url est le chemin stable de l'API, c'est donc celui à conserver. direct_download_url est un lien de stockage signé, et il cesse de fonctionner à l'heure d'expiration indiquée.

3. 01:35Récupérer les résultats

   Appelez results et enregistrez la sortie dans un fichier. Sans filtre, l'API redirige vers le fichier de résultats complet, et dash L suit cette redirection. Vos colonnes viennent en premier, inchangées. Les colonnes ev_ suivent, comme status, score et reason, sur chaque ligne. Vous ne voulez que les lignes à supprimer ? Ajoutez des filtres. Ils se combinent avec OR, donc ceci demande invalide ou jetable. Avec un filtre, le CSV est construit et renvoyé directement. Deux lignes reviennent, celles à supprimer.

4. 02:04Utiliser un webhook

   Le polling fonctionne, mais une longue tâche veut dire beaucoup de requêtes. Un webhook inverse la logique. BillionVerify appelle votre serveur quand une tâche de fichier se termine ou échoue. Enregistrez-en un avec un POST vers /webhooks. Donnez-lui une URL HTTPS et les événements voulus. Il y en a deux : file.completed et file.failed. Cette réponse contient un secret de signature, et c'est la seule fois que vous le verrez. Enregistrez-le tout de suite. Il vous sert à contrôler chaque livraison. Chaque livraison est un POST JSON avec trois en-têtes : l'événement, un horodatage et une signature. Le corps nomme l'événement et l'heure. Son data contient l'ID de la tâche, les compteurs, les crédits utilisés et les liens de téléchargement.

5. 02:44Contrôler la signature

   Contrôlez la signature avant d'agir sur une livraison. Assemblez l'en-tête d'horodatage, un point et le corps brut. Calculez dessus un HMAC-SHA256 avec votre secret, puis comparez avec l'en-tête de signature. Hachez le corps exactement tel qu'il est arrivé. Un JSON analysé puis réencodé ne correspondra pas. Et rejetez les horodatages périmés, pour qu'une ancienne requête ne puisse pas être rejouée. Le flux complet est donc court. Importer, conserver l'ID de tâche, attendre le webhook, puis récupérer les résultats depuis le lien stable.

6. 03:11Prochaines étapes

   Les valeurs de statut, les filtres et chaque champ du webhook figurent dans la référence de l'API, sur billionverify.com/docs/api-reference. 20 crédits gratuits chaque jour où vous utilisez votre compte, jusqu'à 600 par mois. Aucune carte bancaire requise. Commencez sur billionverify.com.