API gratuita del controllo DNS per le email
Una richiesta GET ti dice se i record email di un dominio sono in ordine, cosa correggere e i valori esatti da pubblicare. JSON, CORS attivo, senza registrazione.
- Gratis, anche nei tuoi prodotti
- Senza chiave, CORS attivo
- 30 controlli l’ora per IP
$ curl "https://app.mailsenpai.com/tools/dns-check?domain=example.com"
{
"domain": "example.com",
"status": "checked",
"summary": "3 things to fix",
"checks": {
"spf": { "result": "fix", "label": "Needs fixing", "note": "..." },
"dmarc": { "result": "ok", "label": "OK", "note": "..." },
"dkim": { ... },
"mx": { ... }
},
"tips": [ "..." ],
"records": { "spf": ["v=spf1 -all"], "mx": [], ... },
"cached": false
}Parametri ed esempi
| Nome | Obbligatorio | Descrizione |
|---|---|---|
domain | Sì | Il dominio da controllare, per esempio tuaazienda.it. Va bene anche un URL o un indirizzo email: il dominio viene estratto. |
lang | No | Lingua di etichette, note e consigli: en (predefinita) oppure it. |
selector | No | Un selettore DKIM da provare per primo (il nome prima di ._domainkey), utile quando il servizio di invio ne usa uno poco comune. Senza, si provano i selettori più usati. |
curl "https://app.mailsenpai.com/tools/dns-check?domain=example.com"
const res = await fetch("https://app.mailsenpai.com/tools/dns-check?lang=it&domain=" + encodeURIComponent(dominio));
const resoconto = await res.json();
console.log(resoconto.summary, resoconto.checks.dmarc.result);Descrizione leggibile dai programmi (OpenAPI 3.1): YAML · JSON
Un controllo DNS manuale in Node-RED
Il flusso di esempio usa soltanto nodi integrati e legge la diagnostica di un dominio dimostrativo. Collaudato su Node-RED 4.1.7 e Node.js 20.20.2: risposta HTTP 200 con SPF/DKIM/DMARC/MX ed errore HTTP 422 per dominio mancante. Non richiede chiavi e non invia email.
Leggi istruzioni e limiti della prova · Scarica il flusso JSON da importare
Importa il flusso pubblicato nella libreria ufficiale Node-RED. La scheda e' curata da MailSenpai: la presenza nel catalogo non attesta una recensione indipendente o un'adozione.
Un esempio spiegato in malese
Thalhah Amir illustra il controllo dei record DNS del mittente, con un esempio dell'API MailSenpai, i selettori DKIM e la differenza fra MX assente e null MX. L'articolo e' in malese. Per limiti e risposta del servizio fa fede questa documentazione; la verifica di un messaggio effettivo rimane distinta.
Che cosa ricevi
Risposta vera per example.com, accorciata. Con lang=it i testi arrivano in italiano.
{
"domain": "example.com",
"status": "checked",
"lang": "en",
"summary": "3 things to fix",
"to_fix": 3,
"to_check": 0,
"checks": {
"spf": { "result": "fix", "label": "Needs fixing", "note": "There is an SPF record, but it says no server may send email on behalf of example.com. Record: v=spf1 -all." },
"dmarc": { "result": "ok", "label": "OK", "note": "It exists, with p=reject: email using your domain without permission is rejected. ..." },
"dkim": { ... },
"mx": { ... }
},
"tips": [
"If you send email from example.com, replace the SPF record v=spf1 -all with one that lists the services you send from, ...",
"..."
],
"records": {
"spf": ["v=spf1 -all"],
"dmarc": ["v=DMARC1;p=reject;sp=reject;adkim=s;aspf=s"],
"mx": [],
"dkim_selectors": []
},
"checked_at": "2026-10-08T11:36:47Z",
"cached": false,
"source": "MailSenpai"
}| Campo | Valori |
|---|---|
status | checked (record letti), public_mailbox (gmail.com e simili: i record sono del fornitore), not_found (dominio non registrato), invalid (non è un dominio), dns_unreachable (riprova più tardi). |
checks.*.result | ok, fix (presente ma sbagliato), missing (manca), check (DKIM non trovato sui selettori più usati: passa selector). |
tips | Da due a quattro azioni in ordine di priorità, con i valori da pubblicare. |
records | I record SPF e DMARC così come sono, gli host MX con la priorità, i selettori DKIM trovati. |
cached | true quando lo stesso controllo è stato fatto negli ultimi 15 minuti. |
Regole semplici, senza sorprese
30 controlli l’ora
Dallo stesso indirizzo IP. Le risposte servite dalla memoria di 15 minuti non contano.
Errori chiari
Oltre il limite ricevi HTTP 429; se manca domain ricevi 422. Gli errori hanno una sola forma: {"code": "mspck_error", "message": "...", "data": {"status": 429}}.
Gratis, anche nei tuoi prodotti
Un collegamento al controllo DNS di MailSenpai dove mostri gli esiti è gradito, non obbligatorio.
Solo dati pubblici
L’API legge soltanto record DNS pubblici: non servono account né dati personali.
Usalo da Claude, ChatGPT o Cursor
Lo stesso controllo è lo strumento check_domain_dns del server MCP di MailSenpai, per Claude, ChatGPT, Cursor e gli altri client MCP. Come collegarlo (pagina in inglese).
https://mcp.mailsenpai.com/mcp
tool: check_domain_dns
input: { "domain": "example.com" }Domande frequenti
Serve una chiave API?
No. Chiama l’indirizzo direttamente dal tuo server o dal browser: il CORS è attivo.
Che cosa controlla?
SPF (un solo record, la chiusura, le consultazioni DNS sotto il limite di 10, gli include che non esistono più), DKIM (chiave presente e lunghezza), DMARC (regola, indirizzo dei rapporti, record ereditato dal dominio principale) e MX (quali server e quali filtri antispam ricevono la posta).
Posso usarla in un prodotto a pagamento?
Sì, entro il limite di 30 controlli l’ora per IP. Un collegamento al controllo DNS di MailSenpai dove mostri gli esiti è gradito, non obbligatorio.
Esiste una versione da incorporare?
Sì: il widget gratuito del controllo DNS, due righe di codice senza chiave. Lo trovi nella pagina del widget del controllo DNS.
C’è una descrizione OpenAPI?
Sì, in formato OpenAPI 3.1, in YAML e in JSON: i collegamenti sono sotto gli esempi.
Altri strumenti gratuiti
Preferisci una pagina? Controlla un dominio
Controlla un dominio dal browser e ricevi per email il resoconto completo con le correzioni. Se le email del sito o dell’app partono ancora dall’hosting, SMTP Senpai le firma con DKIM sul tuo dominio, con server di invio in Europa.