API di verifica email via SMTP
Un record MX conferma che il dominio può ricevere posta. La verifica SMTP conferma che quella specifica casella esiste. Mailbeam fa entrambe le cose in una sola chiamata.
Che cosa controlla Mailbeam
Ogni verifica esegue 7 controlli in parallelo e restituisce un risultato strutturato in meno di 100 ms.
Handshake SMTP diretto
Mailbeam si collega al server di posta di destinazione ed esegue EHLO + MAIL FROM + RCPT TO per controllare se quella specifica casella viene accettata, senza consegnare alcun messaggio.
Gestione di MX multipli
I domini con più record MX vengono trattati in ordine di priorità. Se il server principale non risponde, Mailbeam passa automaticamente ai record MX secondari.
Esito del controllo SMTP nella risposta
Il booleano `smtp_check` della risposta ti dice nello specifico se l'handshake SMTP è riuscito, indipendentemente dall'esito composto `valid`.
Gestione elegante dei server che bloccano i sondaggi
Google, Microsoft e alcuni server aziendali bloccano i sondaggi SMTP diretti. Quando il sondaggio è bloccato, Mailbeam usa segnali a livello di dominio e dati storici per stimare la recapitabilità e restituisce `status: unknown` invece di un falso negativo.
Diversa da un controllo solo MX
La validazione MX conferma che il dominio ha infrastruttura di posta. La verifica SMTP conferma che la singola casella esiste (il nome prima della chiocciola). Entrambe girano a ogni richiesta.
Esecuzione in parallelo con gli altri controlli
Il sondaggio SMTP è la parte lenta di una verifica: sintassi, usa e getta e ruolo non costano nulla al suo confronto, e la query MX è di solito in cache. È il sondaggio a decidere il tempo di risposta.
Come funziona
Si ottengono i record MX
Mailbeam risolve i record MX del dominio per identificare il server di posta responsabile. I record dei domini più comuni vengono messi in cache per ridurre la latenza della query DNS.
Si apre la connessione SMTP
Si apre una connessione TCP verso il server MX a priorità più alta sulla porta 25 (o la 587 sui server di solo invio). Mailbeam manda EHLO per presentarsi.
Si invia il comando RCPT TO
Mailbeam emette MAIL FROM con un indirizzo di sondaggio e RCPT TO con l'indirizzo di destinazione. Il codice di risposta del server (250 = accettato, 550 = rifiutato) determina se la casella esiste.
Si chiude la connessione e si restituisce l'esito
Mailbeam invia QUIT e chiude la connessione senza consegnare alcuna posta. Il codice di risposta al RCPT TO viene incluso nel risultato come `smtp_check: true/false`.
Integralo in pochi minuti
import asyncio
import os
import httpx
# Non c'è ancora un SDK: Mailbeam è un unico POST.
async def verify_email(email: str) -> dict:
async with httpx.AsyncClient(timeout=3.0) as client:
response = await client.post(
"https://api.mailbeam.dev/v1/verify",
json={"email": email},
headers={"Authorization": f"Bearer {os.environ['MAILBEAM_KEY']}"},
)
response.raise_for_status()
return response.json()
async def verify_with_smtp_detail(email: str) -> dict:
result = await verify_email(email)
print(f"Controllo SMTP: {result['checks']['smtp']}")
print(f"Controllo MX: {result['checks']['mx']}")
print(f"Stato: {result['status']}")
print(f"Punteggio: {result['score']}")
if result["status"] == "unknown":
# Il sondaggio non è arrivato a un verdetto: Google e Microsoft non si
# sondano mai, e alcuni server applicano il greylisting. Usa il punteggio.
if result["score"] >= 60:
return {"action": "allow", "reason": "domain_signals_positive"}
return {"action": "review", "reason": "low_confidence_unknown"}
if not result["valid"]:
return {"action": "reject", "reason": result["reason"]}
return {"action": "allow", "reason": "smtp_verified"}
# Uso
result = asyncio.run(verify_with_smtp_detail("user@company.com"))
print(result)Quando usarlo
Validazione di liste di prospecting B2B
Prima di lanciare una sequenza a freddo, la verifica SMTP conferma che i contatti specifici che hai individuato nel dominio di un'azienda hanno davvero caselle attive.
Validazione di posta transazionale critica
Prima di inviare fatture, contratti o email di onboarding a nuovi account, verifica l'indirizzo via SMTP per evitare un hard bounce su una comunicazione di grande valore.
Disambiguare i domini catch-all
Sui domini in cui l'MX passa ma la marcatura catch-all è attiva, il sondaggio SMTP viene tentato lo stesso. L'esito del sondaggio e il punteggio limitato danno insieme il verdetto più utile per gli indirizzi aziendali, e il punteggio dice quanta confidenza resta invece di fingere certezza.
Prevenzione degli hard bounce su larga scala
Nelle campagne in cui la reputazione da mittente conta, verificare via SMTP al momento dell'import elimina la classe di hard bounce che nasce da caselle inesistenti.
Domande frequenti
Pronto a integrarlo?
Il piano gratuito include 1.000 verifiche al mese. Senza carta di credito.