API gratuita · senza chiave

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.

GEThttps://app.mailsenpai.com/tools/dns-check?domain=example.com
  • Gratis, anche nei tuoi prodotti
  • Senza chiave, CORS attivo
  • 30 controlli l’ora per IP
4,7/5 · 95 recensioniGoogleGoogleCapterraCapterraTrustpilotTrustpilotG2G2
Terminaleesempio
$ 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
}
riferimento

Parametri ed esempi

NomeObbligatorioDescrizione
domainSìIl dominio da controllare, per esempio tuaazienda.it. Va bene anche un URL o un indirizzo email: il dominio viene estratto.
langNoLingua di etichette, note e consigli: en (predefinita) oppure it.
selectorNoUn 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
curl "https://app.mailsenpai.com/tools/dns-check?domain=example.com"
JavaScript
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.

risposta

Che cosa ricevi

Risposta vera per example.com, accorciata. Con lang=it i testi arrivano in italiano.

200 OK · application/json
{
  "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"
}
CampoValori
statuschecked (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.*.resultok, fix (presente ma sbagliato), missing (manca), check (DKIM non trovato sui selettori più usati: passa selector).
tipsDa due a quattro azioni in ordine di priorità, con i valori da pubblicare.
recordsI record SPF e DMARC così come sono, gli host MX con la priorità, i selettori DKIM trovati.
cachedtrue quando lo stesso controllo è stato fatto negli ultimi 15 minuti.
limiti

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.

assistenti ai

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

MCP server
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.

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.

Gratis · senza chiaveRiferimento