Over deze video

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

Videotranscript

1. 00:00Upload het bestand

   Upload een CSV naar /verify/file en laat een webhook u vertellen wanneer hij klaar is. Bulk stopt bij 50 adressen. Voor alles wat groter is, stuurt u het hele bestand als multipart form data. CSV, TXT en XLSX worden geaccepteerd. email_column noemt de kolom die gelezen moet worden. Laat hem weg, en hij wordt voor u herkend. Dit is het testbestand. Vier rijen, plus een kolom source die we in de resultaten willen houden. De upload wacht niet op de controles. Hij antwoordt met een taak-ID en de status pending. Hij vertelt ook welke kolom hij las, en hoeveel rijen en unieke adressen hij vond. Net als de API-sleutel zelf zijn bestandstaken voor betaalde accounts.

2. 00:43Volg de taak

   Om de status te bekijken, doet u een GET op hetzelfde pad met de taak-ID erbij. Dezelfde header, geen body. Meteen opgevraagd, was dit kleine bestand al aan het samenvoegen. Terwijl het draait, loopt de status door stappen als preparing, pending, processing en merging. Stop met vragen zodra u completed, completed with warning, failed of cancelled ziet. Hier is de afgeronde taak. De tellingen splitsen het bestand per status: één ongeldig, één rol, één catch-all en één wegwerp. credits_used is één, en cache_hit_not_charged is drie. Drie rijen waren hercontroles. Die adressen waren de afgelopen 24 uur op dit account gecontroleerd, en een hercontrole binnen 24 uur wordt niet berekend. Er komen twee links mee. download_url is het stabiele API-pad, dus die slaat u op. direct_download_url is een ondertekende opslaglink, en die werkt niet meer na de getoonde verlooptijd.

3. 01:35Haal de resultaten op

   Roep results aan en sla de uitvoer op in een bestand. Zonder filters stuurt de API door naar het volledige resultatenbestand, en dash L volgt die doorverwijzing. Uw kolommen komen eerst, ongewijzigd. Daarna volgen de ev_-kolommen, zoals status, score en reason, op elke rij. Hebt u alleen de rijen nodig die weg moeten? Voeg filters toe. Ze worden gecombineerd met OR, dus dit vraagt om ongeldig of wegwerp. Met een filter wordt de CSV direct opgebouwd en teruggestuurd. Er komen twee rijen terug, de rijen die weg moeten.

4. 02:04Gebruik een webhook

   Polling werkt, maar bij een lange taak betekent het veel verzoeken. Een webhook draait dat om. BillionVerify roept uw server aan wanneer een bestandstaak klaar is of mislukt. Registreer er een met een POST naar /webhooks. Geef hem een HTTPS-URL en de gewenste gebeurtenissen. Er zijn er twee: file.completed en file.failed. Dat antwoord bevat een ondertekeningsgeheim, en het is de enige keer dat u het ziet. Sla het meteen op. U hebt het nodig om elke bezorging te controleren. Elke bezorging is een JSON-POST met drie headers: de gebeurtenis, een tijdstempel en een handtekening. De body noemt de gebeurtenis en het tijdstip. De data bevat de taak-ID, de tellingen, de gebruikte credits en de downloadlinks.

5. 02:44Controleer de handtekening

   Controleer de handtekening voordat u op een bezorging reageert. Voeg de tijdstempelheader, een punt en de ruwe body samen. Voer HMAC-SHA256 uit over die tekst met uw geheim en vergelijk met de handtekeningheader. Hash de body precies zoals hij binnenkwam. Geparseerde en opnieuw gecodeerde JSON komt niet overeen. En weiger verouderde tijdstempels, zodat een oud verzoek niet opnieuw kan worden afgespeeld. De hele flow is dus kort. Uploaden, de taak-ID opslaan, wachten op de webhook en dan de resultaten ophalen via de stabiele link.

6. 03:11Volgende stappen

   Statuswaarden, filters en elk webhookveld staan in de API-referentie, op billionverify.com/docs/api-reference. 20 gratis credits op elke dag dat u uw account gebruikt, tot 600 per maand. Geen creditcard nodig. Begin op billionverify.com.