Informazioni su questo video

Le risposte in questo video sono risposte API reali, accorciate. Chiavi API, verifica in blocco e di file richiedono un account a pagamento.

Trascrizione del video

1. 00:00La tua prima richiesta

   La tua prima richiesta è una POST a /verify/single. Invia un solo campo JSON, email. Metti la tua chiave API nell’header BV-API-KEY. Questa è l’intera richiesta. Tieni quella chiave in una variabile d’ambiente sul tuo server, mai nel codice client. Creare una chiave richiede un account a pagamento, e qualsiasi acquisto di crediti lo sblocca.

2. 00:24Leggi la risposta

   Questa è la risposta reale per un indirizzo di assistenza. Parti da status. Dice role, perché support è il nome di una casella condivisa, non di una persona. Lo score è zero virgola sei. È un valore ricavato da regole fisse, non una probabilità. Quindi ramifica su status, non sullo score. Is deliverable è true, quindi il server di posta ha accettato questo indirizzo. Anche is catch-all è true, quindi questo dominio accetta qualsiasi indirizzo. Role prende lo status, e i flag mostrano comunque il resto. Reason dà il perché, come un unico codice. Qui è catch-all deliverable.

3. 01:02Perché credits_used è 0

   La documentazione ha una pagina con tutti i codici. Ora credits used. Qui è zero, ma non significa che i controlli siano gratis. Questo account ha già controllato questo indirizzo nelle ultime 24 ore, quindi il controllo ripetuto non è stato addebitato. Un primo controllo come questo costa un credito. Verification mode dice da dove viene la risposta. Questa viene dalla cronologia in cache. Usalo per capire il risultato. Per la fatturazione, leggi credits used.

4. 01:23Fino a 50 indirizzi

   Hai un elenco corto? Usa /verify/bulk. L’header resta lo stesso, e il corpo prende un array emails, fino a 50 indirizzi. I risultati tornano in questa stessa risposta. Ogni indirizzo ha gli stessi campi che hai appena visto. Il primo è catch-all. Il secondo è non valido, perché quella casella non esiste. Il terzo è monouso. Tutti e tre hanno usato un credito. Non valido conta. Il monouso conta qui perché questa richiesta ha impostato check_smtp su true. Omettilo, e una corrispondenza monouso si ferma prima, senza costi. Quindi, per impostazione predefinita, sconosciuto, sintassi errata e monouso non costano nulla. Tutto il resto è un credito, compresi catch-all e ruolo. Sotto i risultati ci sono i totali. Valid emails è zero, perché catch-all non è contato come valido. E i bucket raggruppano il lotto: uno utilizzabile con catch-all, due non recapitabili. Se ne invii più di 50, ottieni un HTTP 400 con codice 3103. L’elenco non viene diviso per te, e non diventa un lavoro su file. L’errore ti indica l’endpoint dei file.

5. 02:28Elenchi più grandi

   Per elenchi più grandi, carica un file. È asincrono, quindi il caricamento ti dà un ID lavoro. Usa quell’ID per controllare l’avanzamento. Quando il lavoro finisce, scarica i risultati. Tieni il flag dash L, perché il download può reindirizzare. Il download è un CSV. Le tue colonne originali restano, e ne seguono di nuove, come ev_status ed ev_reason.

6. 02:49Controlla i tuoi crediti

   /credits ti dice cosa resta. È una GET, con lo stesso header. Controllalo prima di un grande caricamento, perché senza crediti sufficienti l’API restituisce un 402.

7. 03:00Due opzioni di richiesta

   Due opzioni cambiano cosa fa un controllo. SMTP è attivo per impostazione predefinita, e non viene mai inviata alcuna email. check_smtp false salta il server di posta, quindi la maggior parte degli indirizzi torna sconosciuta. force_refresh true salta la cache, e paghi il nuovo risultato.

8. 03:17Errori e limiti

   Gestisci prima tre errori. 401 è una chiave mancante o non valida. 402 significa crediti insufficienti. 429 è un limite di frequenza, quindi rallenta e riprova. I limiti di frequenza valgono per chiave API. 6.000 richieste al minuto su single. 1.500 su bulk.

9. 03:37Prossimi passi

   300 sui caricamenti di file. Questo è l’avvio rapido. Single, bulk, file e crediti. Il riferimento API completo, gli SDK e i webhook sono su billionverify.com/docs. 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.

Presente in questo video