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 esegue otto controlli su ogni indirizzo — sintassi, record MX, esistenza SMTP, domini usa e getta, indirizzi di ruolo, provider gratuiti, domini catch-all e un punteggio di qualità — e restituisce un verdetto, un punteggio su 100 e un codice di motivo leggibile dalla macchina su cui la tua applicazione può ramificare.
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 dal vivo
Ci colleghiamo direttamente al server di posta e confermiamo che la casella esiste, non solo che il dominio ha record MX.
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.
Handshake SMTP
Ci colleghiamo al server di posta e simuliamo un tentativo di consegna per confermare che quella specifica casella esista.
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. La verifica SMTP di domini sconosciuti può arrivare a 500 ms quando il server è lento a rispondere.
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.
Esiste un piano gratuito?
Sì. Il piano gratuito include 1.000 verifiche al mese senza carta di credito, abbastanza per integrare e provare in produzione.
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 arriva con i piani a pagamento. Lo stato dal vivo di ogni componente, controllato a ogni caricamento di pagina, è su mailbeam.dev/status.
Pronto a integrarlo?
Il piano gratuito include 1.000 verifiche al mese. Senza carta di credito.