Avvio rapido
Crea una chiave API nella dashboard, conservala sul server e inviala come credenziale Bearer. Ogni richiesta di verifica accettata consuma un credito.
curl -sS -X POST 'https://api.verifyemail.net/api/v1/verifications' \
-H 'Authorization: Bearer ve_live_your_api_key' \
-H 'Content-Type: application/json' \
-d '{"address":"[email protected]"}'{
"errcode": 0,
"address": "[email protected]",
"is_deliverable": true,
"status": 250,
"catch_all": false,
"disposable": false
}Autenticazione
Crea una chiave API nella dashboard: Dashboard → Chiavi API
Il valore completo ve_live_… viene mostrato una sola volta.
Verifica un’email
/verificationsCorpo della richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| address | string | Sì | Un indirizzo email completo. |
Campi della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
| errcode | number | 0 indica che la richiesta è riuscita; gestisci gli altri valori con la tabella degli errori. |
| address | string | L’indirizzo email normalizzato. |
| is_deliverable | boolean | Indica se il server ricevente accetta il destinatario. |
| status | number | null | Il codice numerico di risposta SMTP, oppure null se non è stata ricevuta alcuna risposta SMTP. |
| catch_all | boolean | null | Indica se il dominio accetta qualsiasi destinatario. Null significa che non è possibile una conclusione affidabile. |
| disposable | boolean | Indica se l’indirizzo appartiene a un dominio email temporaneo. |
250 · HTTP 200 · errcode 0
Il server ricevente ha accettato il destinatario.
550 · HTTP 200 · errcode 0
Il dominio o il server ricevente ha rifiutato il destinatario.
null · HTTP 422
L’indirizzo non è valido o non può essere verificato.
null · HTTP 503
Non è disponibile una conclusione affidabile; riprova più tardi.
È disponibile anche il seguente endpoint GET. È consigliato POST per evitare che gli indirizzi compaiano nei log del proxy o nella cronologia del browser: /verifications?address=…
Controlla i crediti rimanenti
/usageQuesta richiesta non consuma crediti di verifica. Le sessioni della dashboard e tutte le chiavi API dello stesso utente condividono un unico saldo.
curl -sS 'https://api.verifyemail.net/api/v1/usage' \
-H 'Authorization: Bearer ve_live_your_api_key'{
"errcode": 0,
"verification_limit": 100,
"verification_used": 1,
"remaining_verifications": 99,
"unlimited": false
}| Campo | Tipo | Descrizione |
|---|---|---|
| verification_limit | number | Il limite totale corrente. Zero significa illimitato. |
| verification_used | number | Il numero di crediti di verifica già utilizzati. |
| remaining_verifications | number | null | Crediti ancora disponibili; null per gli account illimitati. |
| unlimited | boolean | Indica se il saldo corrente è illimitato. |
I piani illimitati restituiscono remaining_verifications: null, unlimited: true.
Codici di errore
Usa il numero errcode per la logica del programma. Il testo message può cambiare.
{
"errcode": 10006,
"message": "request rate limit exceeded"
}| errcode | HTTP | Significato |
|---|---|---|
| 0 | 2xx | Richiesta riuscita. |
| 10000 | 400 | Richiesta non valida; controlla JSON, header e metodo HTTP. |
| 10001 | 400 / 422 | Un parametro o una regola aziendale non ha superato la validazione. |
| 10002 | 401 | La credenziale manca, non è valida o è scaduta. |
| 10003 | 403 | L’account non può accedere a questa risorsa. |
| 10004 | 404 | La risorsa richiesta non esiste. |
| 10005 | 409 | La risorsa è in conflitto con lo stato corrente. |
| 10006 | 429 | È stato superato il limite di richieste al secondo. |
| 10007 | 429 | I crediti di verifica sono esauriti. |
| 10008 | 429 | La capacità concorrente del servizio è esaurita. |
| 10009 | 500 | Si è verificato un errore interno del servizio. |
| 10010 | 503 | Il servizio è temporaneamente non disponibile o non configurato. |
| 10011 | 502 | Un servizio a monte ha restituito un errore. |
Header di limite
Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset — descrivono la finestra di richieste corrente.