Over deze video

Antwoorden in deze video zijn echte API-antwoorden, ingekort. API-sleutels, bulk- en bestandsverificatie vereisen een betaald account.

Videotranscript

1. 00:00Uw eerste verzoek

   Uw eerste verzoek is een POST naar /verify/single. Stuur één JSON-veld, email. Zet uw API-sleutel in de header BV-API-KEY. Dat is het hele verzoek. Bewaar die sleutel in een omgevingsvariabele op uw server, nooit in clientcode. Een sleutel maken vereist een betaald account, en elke aankoop van credits ontgrendelt dat.

2. 00:24Lees het antwoord

   Dit is het echte antwoord voor een supportadres. Begin bij status. Die zegt role, omdat support de naam is van een gedeelde mailbox, niet van een persoon. De score is nul komma zes. Dat is een waarde uit vaste regels, geen kans. Beslis dus op status, niet op de score. Is deliverable is true, dus de mailserver accepteerde dit adres. Is catch-all is ook true, dus dit domein accepteert elk adres. Role krijgt de status, en de vlaggen tonen de rest nog steeds. Reason geeft het waarom, als één code. Hier is het catch-all deliverable.

3. 01:02Waarom credits_used 0 is

   De documentatie heeft een pagina met alle codes. Nu credits used. Dat is hier nul, maar dat betekent niet dat controles gratis zijn. Dit account controleerde dit adres de afgelopen 24 uur al, dus de herhaling werd niet berekend. Een eerste controle als deze kost één credit. Verification mode zegt waar het antwoord vandaan kwam. Dit kwam uit de gecachete geschiedenis. Gebruik het om het resultaat te begrijpen. Lees voor de facturering credits used.

4. 01:23Tot 50 adressen

   Een korte lijst? Gebruik /verify/bulk. De header blijft hetzelfde, en de body neemt een emails-array, tot 50 adressen. De resultaten komen terug in ditzelfde antwoord. Elk adres krijgt dezelfde velden die u net zag. Het eerste is catch-all. Het tweede is ongeldig, want die mailbox bestaat niet. Het derde is wegwerp. Alle drie gebruikten een credit. Ongeldig telt. Wegwerp telt hier mee omdat dit verzoek check_smtp op true zette. Laat dat weg, en een wegwerp-treffer stopt vroeg, zonder kosten. Standaard kosten onbekend, ongeldige syntaxis en wegwerp dus niets. Al het andere is één credit, catch-all en rol inbegrepen. Onder de resultaten staan totalen. Valid emails is nul, omdat catch-all niet als geldig telt. En de buckets groeperen de batch: één bruikbaar met catch-all, twee niet bezorgbaar. Stuurt u meer dan 50, dan krijgt u een HTTP 400 met code 3103. De lijst wordt niet voor u gesplitst en wordt geen bestandstaak. De fout verwijst u naar het bestandsendpoint.

5. 02:28Grotere lijsten

   Upload voor grotere lijsten een bestand. Het is asynchroon, dus de upload geeft u een taak-ID. Gebruik die ID om de voortgang te volgen. Download de resultaten als de taak klaar is. Houd de vlag dash L, want de download kan doorverwijzen. De download is een CSV. Uw oorspronkelijke kolommen blijven, en nieuwe volgen, zoals ev_status en ev_reason.

6. 02:49Controleer uw credits

   /credits laat zien wat er over is. Het is een GET, met dezelfde header. Controleer het vóór een grote upload, want zonder genoeg credits geeft de API een 402.

7. 03:00Twee verzoekopties

   Twee opties veranderen wat een controle doet. SMTP staat standaard aan, en er wordt nooit een e-mail verstuurd. check_smtp false slaat de mailserver over, dus de meeste adressen komen terug als onbekend. force_refresh true slaat de cache over, en u betaalt voor het nieuwe resultaat.

8. 03:17Fouten en limieten

   Handel eerst drie fouten af. 401 is een ontbrekende of ongeldige sleutel. 402 betekent te weinig credits. 429 is een limiet, dus vertraag en probeer opnieuw. Limieten gelden per API-sleutel. 6.000 verzoeken per minuut op single. 1.500 op bulk.

9. 03:37Volgende stappen

   300 op bestandsuploads. Dat is de snelstart. Single, bulk, bestand en credits. De volledige API-referentie, SDK's en webhooks staan op billionverify.com/docs. 20 gratis credits op elke dag dat u uw account gebruikt, tot 600 per maand. Geen creditcard nodig. Begin op billionverify.com.

Te zien in deze video