API di verifica delle email per sviluppatori
Un solo endpoint REST. Verifica qualsiasi email in meno di 100 ms. Ospitata nell'UE, conforme al GDPR e con esempi per Node, Python, PHP, Ruby e Go.
- Che cos'è un'API di verifica delle email?
- Un'API di verifica delle email è un endpoint HTTP che dice se un indirizzo email è reale e recapitabile prima che tu gli scriva. Mailbeam controlla su ogni indirizzo la sintassi, i record MX, i domini usa e getta, le caselle di ruolo e i provider gratuiti — la verifica della casella via SMTP è nella roadmap — e restituisce un verdetto, un punteggio su 100 e un codice di motivo leggibile dalla macchina su cui la tua applicazione può decidere.
Che cosa controlla Mailbeam
Ogni verifica esegue 7 controlli in parallelo e restituisce un risultato strutturato in meno di 100 ms.
Risposta in meno di 100 ms
Verifica le email in tempo reale durante la registrazione senza aggiungere latenza percepibile al flusso dei tuoi utenti.
Verifica SMTP, nella roadmap
La verifica della casella via SMTP è in arrivo. Oggi il verdetto si basa su sintassi, MX/DNS, liste di usa e getta e caselle di ruolo.
Ospitata nell'UE, prima il GDPR
Tutta l'elaborazione avviene su infrastruttura europea. Nessuna conservazione dei dati dopo la verifica. DPA disponibile ai sensi dell'articolo 28.
Esempi per qualsiasi stack
Node.js, Python, PHP, Ruby e Go. È un POST con un JSON: una dozzina di righe del tuo client HTTP abituale e l'integrazione è fatta.
Rilevamento di usa e getta e caselle di ruolo
Blocca gli indirizzi temporanei e le caselle di reparto (info@, admin@) con un database aggiornato di continuo.
Suggerimento sui refusi
Quando qualcuno scrive «gmal.com», restituiamo «gmail.com» all'istante perché lo corregga prima di inviare il modulo.
Come funziona
Invia una richiesta POST
Manda l'indirizzo a /v1/verify con la tua API key nell'header Authorization. Tutto qui.
Query DNS e record MX
Mailbeam interroga il DNS del dominio per confermare che possa ricevere posta.
Controlli su dominio e indirizzo
L'indirizzo viene confrontato con le liste di domini usa e getta e con i prefissi di ruolo (info@, admin@). La verifica della casella con un ping di un'email, via SMTP, è nella roadmap.
Risultato JSON strutturato
Ricevi un JSON con lo stato (deliverable/risky/undeliverable/unknown), un punteggio da 0 a 100 e l'esito di ogni controllo.
Integralo in pochi minuti
curl -X POST https://api.mailbeam.dev/v1/verify \
-H "Authorization: Bearer $MAILBEAM_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "utente@esempio.com"}'
# Risposta:
# {
# "email": "utente@esempio.com",
# "status": "deliverable",
# "score": 97,
# "valid": true,
# "disposable": false,
# "role": false,
# "suggestion": null
# }Quando usarlo
Moduli di registrazione
Valida al momento dell'iscrizione per fermare le email false e scritte male prima che entrino nel tuo sistema.
Integrazioni via API
Verifica le email da qualsiasi backend: un POST con corpo JSON, senza libreria client obbligatoria.
Webhook e flussi asincroni
Invia una lista all'endpoint batch e lascia che un webhook firmato batch.completed ti avvisi quando è pronta, invece di fare polling.
Arricchimento del CRM
Aggiungi stato di verifica e punteggio ai tuoi contatti per alimentare il lead scoring e l'assegnazione commerciale.
Domande frequenti
Quanto è veloce l'API?
Mailbeam risponde in meno di 100 ms al 99° percentile per la maggior parte dei domini. Un dominio il cui DNS è lento a rispondere può richiedere un po' di più.
Ci sono SDK ufficiali?
Non ancora: le librerie ufficiali per Node.js, Python, PHP, Ruby e Go sono in roadmap e l'API REST arriva prima. È un unico POST con corpo JSON, quindi bastano poche righe del tuo client HTTP; la guida introduttiva include un wrapper da copiare per ogni linguaggio.
Quanto costa?
Mailbeam è solo a pagamento: i piani partono da 5 € al mese per 1.000 verifiche. Le chiavi di test (mb_test_) restituiscono risultati simulati e non contano su nessuna quota, quindi puoi fare l'integrazione prima di pagare.
L'API conserva gli indirizzi email?
Nella verifica in tempo reale no: l'indirizzo viene scartato appena la risposta è restituita. L'eccezione sono i lavori in blocco, la cui lista e i cui risultati restano 72 ore per permetterti di scaricarli e poi vengono cancellati automaticamente. Mailbeam è conforme al GDPR ed è ospitata nell'UE.
Che SLA offrite?
Lo SLA contrattuale è nella roadmap. Lo stato dal vivo di ogni componente, controllato a ogni caricamento di pagina, è su mailbeam.dev/status.
Pronto a integrarlo?
Scegli il piano adatto al tuo volume. Ogni account include chiavi di test per la tua CI.