Vai al contenuto
Docs

Guida pratica

Verifica un singolo indirizzo

Verifica un indirizzo email nel pannello o con l’API, scegli tra modalità rapida e completa e usa la verifica per bloccare gli indirizzi errati al momento dell’iscrizione.

Aggiornato il 9 ott 2026

Questa guida mostra come controllare un indirizzo email, a mano nel pannello oppure dal codice con l’API. Spiega anche come usare la verifica in un modulo di iscrizione per bloccare refusi e indirizzi usa e getta prima che arrivino nella lista.

Prima di iniziare

  • Ogni verifica costa 5 crediti. Controlla il saldo nella barra laterale o in WorkspaceBilling.
  • Per l’API, usa una chiave API con Full Access. Le chiavi di solo invio non possono verificare indirizzi.

Modalità rapida e completa

Modalità Controlli Usala per
fast (predefinita nell’API) Sintassi, record MX, età del dominio, indirizzi usa e getta, di ruolo, di provider gratuiti e dall’aspetto casuale Moduli di iscrizione e tutto ciò per cui una persona sta aspettando.
full (pannello) Tutto ciò che fa fast, più una connessione al server di posta del destinatario per controllare la casella: consegnabile, disattivata, piena e catch-all Sapere se una casella esiste, ad esempio prima di un invio importante, quando qualche secondo in più non conta.

Le due modalità costano uguale. full richiede più tempo, di solito qualche secondo e fino a circa 40 secondi, perché dialoga con il server di posta del destinatario, che può essere lento o rifiutarsi di rispondere. Quando si rifiuta, l’esito è unknown invece di un’ipotesi. Per il significato di ogni controllo, vedi Come funziona il controllo della casella ed Esiti della verifica.

Verifica un indirizzo

  1. Apri Email Verification. Vai a Email VerificationEmails e seleziona Verify Email.

  2. Inserisci l’indirizzo. Scrivilo nel campo Email e seleziona Verify Email. Il pannello usa la modalità full, quindi controlla anche la casella.

  3. Apri l’esito. L’indirizzo compare nell’elenco con Status, Result, Risk, Score, la data Created e i giorni che mancano a Expiring. Selezionalo per vedere ogni singolo controllo, come Deliverable, Catch-all, Valid Syntax, Disposable, Role Account e Has MX Records. Un controllo a cui il server di posta non ha risposto in modo chiaro mostra Unknown.

Per controllare molti indirizzi in una volta, verifica una lista.

Verifica gli indirizzi all’iscrizione

Controllare un indirizzo quando qualcuno lo digita è il modo più economico per mantenere pulita una lista. Un refuso intercettato all’iscrizione non diventa mai un bounce.

  1. Chiama l’API dal server. Non inserire mai la chiave API nel codice del browser. Invia l’indirizzo dal gestore dell’iscrizione, in modalità fast.

  2. Imposta un timeout e lascia passare in caso di errore. Se la verifica è lenta o restituisce un errore, lascia completare l’iscrizione. Perdere un cliente reale costa più di un indirizzo sbagliato.

  3. Agisci in base all’esito. Blocca ciò che è chiaramente sbagliato, suggerisci correzioni per i refusi e lascia passare tutto il resto.

verify-signup.js
export async function checkSignupEmail(email) {
  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), 5000);

  try {
    const res = await fetch('https://api.emailit.com/v2/email-verifications', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ email, mode: 'fast' }),
      signal: controller.signal,
    });
    if (!res.ok) return { ok: true }; // fail open

    const verification = await res.json();

    if (verification.result === 'invalid') {
      return {
        ok: false,
        message: verification.did_you_mean
          ? `Did you mean ${verification.did_you_mean}?`
          : 'Please check your email address.',
      };
    }
    if (verification.result === 'disposable') {
      return { ok: false, message: 'Please use a permanent email address.' };
    }

    // Accept the address, but offer a correction if one looks likely.
    return { ok: true, suggestion: verification.did_you_mean };
  } catch {
    return { ok: true }; // timeout or network error: fail open
  } finally {
    clearTimeout(timer);
  }
}

Alcuni consigli:

  • Usa did_you_mean. Per i refusi più comuni nei domini, come ada@gmial.com, contiene l’indirizzo probabile, ada@gmail.com. Mostralo come suggerimento che la persona può accettare.
  • Non bloccare a priori gli indirizzi di ruolo. info@ o sales@ sono spesso il modo in cui le piccole aziende si iscrivono. Segnalali invece di bloccarli.
  • Verifica ogni indirizzo una sola volta. Ogni chiamata costa crediti, quindi verifica quando il modulo viene inviato, non a ogni tasto premuto, e memorizza l’esito.
Il significato di ogni esito, rischio e controllo.
Controlla fino a 10.000 indirizzi in una volta.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.