Riferimento per sviluppatori

Deliverability Email Documentazione API

Deliverability Email Documentazione API: Analisi completa dell'autenticazione e della deliverability email con audit SPF, DKIM, DMARC.

Deliverability Email

Analisi completa dell'autenticazione e della deliverability email con audit SPF, DKIM, DMARC.

GET /v1/recipes/email-deliverability

Parametri di query

Parametro	Tipo	obbligatorio
domain	string	obbligatorio
dkim_selectors	string	facoltativo
check_blacklists	boolean	facoltativo

Campi di risposta

Campo	Tipo
`success`	boolean
`data`	object
`data.domain`	string
`data.grade`	string
`data.score`	number
`data.authentication`	object
`data.authentication.spf`	object
`data.authentication.spf.status`	string
`data.authentication.spf.record`	string
`data.authentication.spf.issues[]`	array
`data.authentication.dkim`	object
`data.authentication.dkim.status`	string
`data.authentication.dkim.record`	string
`data.authentication.dkim.issues[]`	string[]
`data.authentication.dkim.recommendation`	string
`data.authentication.dkim.selectors_found[]`	string[]
`data.authentication.dmarc`	object
`data.authentication.dmarc.status`	string
`data.authentication.dmarc.record`	string
`data.authentication.dmarc.issues[]`	string[]
`data.authentication.dmarc.recommendation`	string
`data.authentication.dmarc.policy`	string
`data.infrastructure`	object
`data.infrastructure.mx_servers[]`	string[]
`data.infrastructure.ip_reputation`	string
`data.infrastructure.shared_ip_risk`	string
`data.blacklist_status`	object
`data.blacklist_status.listed_on[]`	array
`data.blacklist_status.clean`	boolean
`data.action_items[]`	object[]
`data.action_items[]`	object
`data.action_items[].priority`	string
`data.action_items[].category`	string
`data.action_items[].action`	string
`data.action_items[].details`	string
`data.action_items[].estimated_impact`	string
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	array
`meta.timestamp`	string
`errors[]`	array

Richiesta di esempio

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/email-deliverability?domain=example.com&dkim_selectors=example.com&check_blacklists=example.com"

Risposta di esempio

{
  "success": true,
  "data": {
    "domain": "example.com",
    "grade": "B",
    "score": 74,
    "authentication": {
      "spf": {
        "status": "pass",
        "record": "v=spf1 include:_spf.google.com ~all",
        "issues": []
      },
      "dkim": {
        "status": "warning",
        "record": "selector discovery incomplete",
        "issues": [
          "Only one selector found"
        ],
        "recommendation": "Add dedicated selectors for all providers",
        "selectors_found": [
          "google"
        ]
      },
      "dmarc": {
        "status": "warning",
        "record": "v=DMARC1; p=none; rua=mailto:dmarc@example.com",
        "issues": [
          "Policy is monitoring-only"
        ],
        "recommendation": "Move to quarantine or reject",
        "policy": "none"
      }
    },
    "infrastructure": {
      "mx_servers": [
        "aspmx.l.google.com"
      ],
      "ip_reputation": "low",
      "shared_ip_risk": "medium"
    },
    "blacklist_status": {
      "listed_on": [],
      "clean": true
    },
    "action_items": [
      {
        "priority": "high",
        "category": "email",
        "action": "Strengthen DMARC policy",
        "details": "Current DMARC policy is set to none.",
        "estimated_impact": "Better spoofing protection"
      }
    ]
  },
  "meta": {
    "recipe_name": "email-deliverability",
    "credits_used": 8,
    "credits_saved": 7,
    "duration_ms": 662,
    "components_called": [
      "dns-security",
      "dnsbl",
      "mx-analysis"
    ],
    "cached_components": [],
    "timestamp": "2026-04-15T10:43:00Z"
  },
  "errors": []
}