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. Si consiglia di utilizzare l'API a posteriori perché una verifica può essere più o meno lunga (1 minuto).
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,
"ok_for_all":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. |
ok_for_all | 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. |