API V2
La versione 2 dell'API Captain Verify è ora disponibile e include nuove funzionalità. Se stai cercando un modo affidabile per verificare la validità delle tue e-mail, puoi integrare l'API di verifica e-mail di Captain Verify nelle tue applicazioni.
Chiave dell'API
È necessario un account per generare la chiave per l'API, questo è ciò che ti darà accesso al servizio.
Limiti dell'API
L'API è limitata a un massimo di 2 connessioni simultanee e 50 controlli al minuto. Quando integri l'API, assicurati che la tua applicazione non superi questo limite.
La richiesta
Per effettuare una richiesta all'API, basta chiamare il protocollo GET a questo URL:
https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com
Sostituisci john.doe@gmail.com con la tua email per verificare.
La risposta
Verrà restituita una tabella json con queste variabili:
{
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok4all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
| Variabili | Valore possibile |
|---|---|
| credits | Crediti disponibili nel tuo account. |
| result | valid, invalid, risky, unknown Lo stato dell'e-mail. se tutti i tuoi crediti sono stati esauriti, verrà sempre restituito lo stato sconosciuto, in modo da non bloccare la tua candidatura. |
| details | null, email error, greylisting, low quality, low deliverability, mailboxfull... Comprendere il risultato di un audit. |
| free | true, false Se il provider di posta elettronica è gratuito, ad esempio Gmail.com. |
| role | true, false Se l'utente di posta elettronica ha un ruolo, ad esempio: support@example.com. |
| disposable | true, false L'email è valida, ma disponibile dopo poco tempo non sarà più possibile contattare l'utente. |
| ok4all | true, false Ok per tutti: il server di posta remoto accetta tutte le e-mail (catch-all). |
| protected | true, false L'e-mail è protetta da una soluzione antispam proprietaria |
| mailboxfull | true, false L'indirizzo e-mail è pieno. Non può più ricevere posta |
| did_you_mean | default : null Se, ad esempio, l'email è john.doe@gmil.com, l'API ti invierà una proposta come john.doe@gmail.com. |
| L'e-mail che desideri verificare. | |
| email_normalized | L'email è stata normalizzata, rimuovendo i tag per gmail...support+test@gmail.com sarà support@gmail.com. |
| success | true, false Se l'autenticazione fallisce, i tuoi crediti sono esauriti. |
| message | default : null Quando il successo è falso, verrà inviato un messaggio di errore. |
Perché integrare un'API di verifica email?
Un database di contatti si degrada rapidamente. Indirizzi inseriti con un errore di battitura, email usa e getta create per superare un modulo, caselle abbandonate e poi chiuse: ogni indirizzo non valido che entra nel tuo sistema finisce in hard bounce. E i bounce costano cari. Gonfiano le tue fatture di invio, falsano le statistiche delle tue campagne e, soprattutto, danneggiano la tua reputazione del mittente presso i provider di posta elettronica.
La pulizia manuale arriva sempre troppo tardi. Una volta registrato nel tuo CRM, l'indirizzo ha già inquinato i tuoi segmenti, i tuoi lead score e le tue esportazioni. La verifica programmatica inverte la logica: l'indirizzo viene controllato nel momento esatto della raccolta, prima di essere memorizzato.
È esattamente questo il ruolo di un'API di verifica email. Invii un indirizzo, ricevi un verdetto utilizzabile dal tuo codice e decidi cosa farne: accettare, rifiutare o chiedere una correzione all'utente. Il tutto senza alcun intervento umano.
Casi d'uso dell'API
Validazione in tempo reale alla registrazione
Collega l'API ai tuoi moduli di registrazione, download o richiesta di preventivo. Gli errori di battitura (gmail diventato gmial), le email usa e getta e gli indirizzi inesistenti vengono rilevati prima della registrazione. L'utente può correggere subito quanto digitato e solo indirizzi validi entrano nel tuo database.
Pulizia in blocco prima di una campagna
Una lista che dorme per qualche mese accumula indirizzi morti. Prima di un invio importante, passala all'API per escludere gli indirizzi non validi o a rischio. Risultato: un bounce rate sotto controllo, statistiche di campagna affidabili e un budget di invio concentrato su destinatari che esistono davvero.
Affidabilità del CRM
Collega la verifica ai tuoi punti di ingresso dei dati: importazioni, integrazioni, inserimenti commerciali. Ogni contatto viene qualificato fin dalla sua creazione, con uno stato chiaro sulla validità della sua email. I tuoi team lavorano su schede pulite e il tuo lead scoring si basa su dati reali.
Protezione della reputazione del mittente
I provider di posta elettronica monitorano i tuoi hard bounce e i tuoi invii verso spam trap. Troppi incidenti, e le tue email legittime finiscono nello spam. Filtrando gli indirizzi pericolosi prima di ogni invio, l'API protegge la tua reputazione del mittente e quindi la deliverability di tutte le tue comunicazioni.
Domande frequenti sull'API
Cosa verifica esattamente l'API?
Diversi controlli si susseguono: sintassi dell'indirizzo, esistenza del dominio e dei suoi record MX, poi test SMTP per verificare che la casella accetti i messaggi. L'API rileva anche le email usa e getta e gli indirizzi di ruolo (contact@, info@). La risposta viene restituita in formato JSON.
L'API funziona in tempo reale?
Sì. Ogni richiesta attiva una verifica immediata e restituisce subito il risultato, il che permette di integrarla direttamente in un modulo o in un percorso di registrazione. Per i grandi volumi, la verifica di file completi resta disponibile dal tuo account.
Quanto costa?
La fatturazione funziona a crediti: una verifica consuma un credito, senza abbonamento obbligatorio. I crediti acquistati servono sia per l'API sia per la verifica di file. Il dettaglio dei volumi e dei prezzi decrescenti è disponibile sulla pagina dei nostri prezzi.