Mailbeam
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.

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

1

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.

2

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.

3

Una corrispondenza ad alta confidenza restituisce un suggerimento

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

4

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) });
}

Quando usarlo

Moduli di registrazione

Il momento in cui un refuso fa più danno: un indirizzo sbagliato qui rompe l'attivazione e tutte le email successive.

Campi email del checkout

Recupera la conferma d'ordine che altrimenti farebbe bounce per un tasto premuto male.

Raccolta di lead

Smetti di perdere lead qualificati per un dominio scritto male in un modulo.

Cambi di email dell'account

Conferma che il nuovo indirizzo è quello che l'utente voleva prima di spostargli le notifiche.

Domande frequenti

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.

Pronto a integrarlo?

Il piano gratuito include 1.000 verifiche al mese. Senza carta di credito.