Documenti API di convalida delle e-mail

Stato API

Come iniziare

Tutte le richieste API richiedono l'autenticazione tramite una chiave API. La chiave API è disponibile nella dashboard.

Intestazione: "x-api-key: your-api-key"

Verifica singola

Verificare la validità di un singolo indirizzo e-mail o di un dominio, lo stato "usa e getta", i servizi di privacy e la deliverability.

Punto finale

GET /v1/verify

Parametri

NomeTipoRichiestoDescrizione
inputstringIndirizzo e-mail o dominio da verificare (ad esempio, [email protected] o example.com)

apiDocs.responseFields

CampoDescrizione
validIndica se il formato dell'e-mail è corretto
blockIndica se l'email deve essere bloccata (vero se usa e getta, privacy, applePrivateEmail, deliverable o catch_all è vero)
disposableDetermina se l'indirizzo e-mail è temporaneo o usa e getta.
privacyDetermina se il server di posta utilizza un alias o un forwarder di posta elettronica.
applePrivateEmailIndica se l'e-mail è un indirizzo e-mail privato Apple.
deliverableControlla se la casella di posta elettronica esiste e può ricevere e-mail.
domainLa parte del dominio dell'indirizzo e-mail
email_addressL'indirizzo e-mail
catch_allIndica se il dominio ha una configurazione di email catch-all che accetta tutte le email in arrivo indipendentemente dall'indirizzo del destinatario.
mx_foundIndica se il dominio ha server di posta validi (record MX).
remaining_creditsIl numero di crediti API rimanenti nel vostro account

Esempio di risposta

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Esempi di codice

curl "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

Provate

Per testare gli endpoint è necessaria una chiave API.

Da provare con:

Verifica dei lotti

Verifica di più indirizzi e-mail o domini in un'unica richiesta (max 100 elementi).

Punto finale

POST /v1/verify/batch

Parametri

NomeTipoRichiestoDescrizione
inputsarray of stringsSerie di indirizzi e-mail o domini da verificare

Esempi di codice

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "[email protected]",
      "[email protected]"
    ]
  }'

Provate

Per testare gli endpoint è necessaria una chiave API.

Provate con domini diversi: