Informazioni su questo video

Le risposte in questo video sono risposte reali dell’API, abbreviate. Le chiavi API e la verifica di file richiedono un account a pagamento.

Trascrizione del video

1. 00:00Carica il file

   Carica un CSV su /verify/file, poi lascia che sia un webhook a dirti quando ha finito. Bulk si ferma a 50 indirizzi. Per qualsiasi cosa più grande, invia l’intero file come multipart form data. Sono accettati CSV, TXT e XLSX. email_column indica la colonna da leggere. Omettilo, e viene rilevata al posto tuo. Questo è il file di prova. Quattro righe, più una colonna source che vogliamo tenere nei risultati. Il caricamento non aspetta i controlli. Risponde con un ID attività e uno stato pending. Ti dice anche quale colonna ha letto e quante righe e indirizzi unici ha trovato. Come la chiave API stessa, i lavori su file sono per account a pagamento.

2. 00:43Segui il lavoro

   Per controllarlo, fai una GET sullo stesso percorso con l’ID attività aggiunto. Stesso header, nessun corpo. Richiesto subito, questo piccolo file era già in fase di merging. Mentre gira, lo stato passa per passaggi come preparing, pending, processing e merging. Smetti di chiedere quando vedi completed, completed with warning, failed o cancelled. Ecco il lavoro finito. I conteggi dividono il file per stato: un non valido, un ruolo, un catch-all e un monouso. credits_used è uno, e cache_hit_not_charged è tre. Tre righe erano ricontrolli. Quegli indirizzi erano stati controllati su questo account nelle ultime 24 ore, e un ricontrollo entro 24 ore non viene addebitato. Arrivano due link. download_url è il percorso API stabile, quindi è quello da salvare. direct_download_url è un link firmato allo storage, e smette di funzionare alla scadenza indicata.

3. 01:35Ottieni i risultati

   Chiama results e salva l’output in un file. Senza filtri, l’API reindirizza al file completo dei risultati, e dash L segue quel reindirizzamento. Le tue colonne vengono per prime, invariate. Poi seguono le colonne ev_, come status, score e reason, su ogni riga. Ti servono solo le righe da rimuovere? Aggiungi i filtri. Si combinano con OR, quindi questo chiede non validi o monouso. Con un filtro, il CSV viene creato e restituito direttamente. Tornano due righe, quelle da rimuovere.

4. 02:04Usa un webhook

   Il polling funziona, ma un lavoro lungo significa molte richieste. Un webhook rovescia la cosa. BillionVerify chiama il tuo server quando un lavoro su file finisce o fallisce. Registrane uno con una POST a /webhooks. Dagli un URL HTTPS e gli eventi che vuoi. Sono due: file.completed e file.failed. Quella risposta porta un segreto di firma, ed è l’unica volta che lo vedrai. Salvalo subito. Ti serve per controllare ogni consegna. Ogni consegna è una POST JSON con tre header: l’evento, un timestamp e una firma. Il corpo nomina l’evento e l’ora. I suoi data portano l’ID del lavoro, i conteggi, i crediti usati e i link di download.

5. 02:44Controlla la firma

   Controlla la firma prima di agire su una consegna. Unisci l’header del timestamp, un punto e il corpo grezzo. Esegui HMAC-SHA256 su quella stringa con il tuo segreto, e confronta con l’header della firma. Calcola l’hash del corpo esattamente come è arrivato. Un JSON analizzato e ricodificato non corrisponderà. E rifiuta i timestamp vecchi, così una vecchia richiesta non può essere riprodotta. Quindi il flusso completo è breve. Carica, salva l’ID attività, aspetta il webhook, poi recupera i risultati dal link stabile.

6. 03:11Prossimi passi

   Valori di stato, filtri e ogni campo del webhook sono nel riferimento API, su billionverify.com/docs/api-reference. 20 crediti gratuiti ogni giorno in cui usi il tuo account, fino a 600 al mese. Nessuna carta di credito richiesta. Inizia su billionverify.com.