Come viene generato il suggerimento?

Il dominio viene confrontato con un ampio insieme di grafie di provider e domini di primo livello comuni tramite distanza di edit. Quando c'è un'unica corrispondenza vicina e ad alta confidenza, viene restituito quell'indirizzo corretto nel campo suggestion.

Può «correggere» per errore un dominio aziendale valido?

No. I suggerimenti scattano solo su quasi-corrispondenze ad alta confidenza rispetto a provider molto noti. Un dominio aziendale valido ma poco comune non fa scattare alcun suggerimento, perché non è a un passo da nulla di noto.

Cambia la parte prima della chiocciola?

No. Viene corretto solo il dominio. La parte locale resta esattamente uguale, quindi accettare un suggerimento è sempre sicuro.

Sistema i domini di primo livello sbagliati come .cm o .co?

Sì. I domini troncati o scritti male come gmail.co, gmail.cm e gmail.con restituiscono tutti un suggerimento di gmail.com.

Devo applicare il suggerimento automaticamente?

No, e non dovresti. Presentalo come un avviso che l'utente conferma. Applicarlo da solo rischia di sovrascrivere un indirizzo che l'utente voleva davvero.

API · Correzione

API di correzione dei refusi nelle email

Un solo dominio scritto male è una registrazione che non si attiva mai. Restituisci all'istante un suggerimento «intendevi...?» perché l'utente lo corregga con un tocco.

Prova gratis la correzione dei refusi, senza API key Ottieni l'accesso gratuito all'API

Che cosa controlla Mailbeam

Ogni verifica esegue 7 controlli in parallelo e restituisce un risultato strutturato in meno di 100 ms.

Suggerimenti di dominio nella risposta

Quando il dominio è a un passo da un provider noto (gmal.com, yaho.com, hotmial.com), la risposta include un campo con il suggerimento corretto.

Confronto per distanza di edit

I suggerimenti si basano sulla vicinanza a un ampio insieme di grafie comuni di caselle e domini di primo livello, non su una lista corta scritta a mano, quindi vengono intercettati anche i refusi meno frequenti.

Riparazione del dominio di primo livello

Corregge i domini di primo livello troncati o sbagliati: gmail.co e gmail.cm restituiscono entrambi un suggerimento di gmail.com.

Conserva la parte locale

Viene corretto solo il dominio; jane.doe resta jane.doe, quindi il suggerimento si può accettare così com'è senza rischi.

Correzione con un tocco

Mostra il suggerimento come un avviso cliccabile perché l'utente sistemi l'indirizzo senza riscriverlo per intero.

Conservativa per scelta

I suggerimenti scattano solo su quasi-corrispondenze ad alta confidenza, quindi un dominio valido poco comune non viene mai messo in dubbio.

Come funziona

Fai POST dell'indirizzo digitato

Invia l'indirizzo così com'è a /v1/verify quando l'utente invia il modulo, oppure alla perdita di focus del campo per correggere in linea.

Si confronta il dominio con i provider noti

Il dominio viene confrontato con un ampio corpus di provider e domini di primo livello comuni usando la distanza di edit.

Una corrispondenza ad alta confidenza restituisce un suggerimento

Se esiste una corrispondenza vicina e inequivocabile, la risposta porta suggestion: 'jane.doe@gmail.com'.

Tu lo proponi all'utente

Mostra «Intendevi jane.doe@gmail.com?» e lascia che lo accetti con un tocco prima di creare l'account.

Integralo in pochi minuti

Suggerire una correzionetypescript

const res = await fetch("https://api.mailbeam.dev/v1/verify", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.MAILBEAM_KEY}` },
  body: JSON.stringify({ email }),
});
const { suggestion } = await res.json();

if (suggestion) {
  // es. suggestion = "jane.doe@gmail.com"
  showPrompt(`Intendevi ${suggestion}?`, { onAccept: () => setEmail(suggestion) });
}

Guida introduttiva →Riferimento API