مرجع المطورين

قابلية تسليم البريد الإلكتروني

باستخدام DomScan API، تحليل شامل لمصادقة البريد الإلكتروني وقابلية التسليم مع تدقيق SPF وDKIM وDMARC.

قابلية تسليم البريد الإلكتروني

تحليل شامل لمصادقة البريد الإلكتروني وقابلية التسليم مع تدقيق SPF وDKIM وDMARC.

GET /v1/recipes/email-deliverability

معاملات الاستعلام

المعامل	النوع	مطلوب
domain	string	مطلوب
dkim_selectors	string	اختياري
check_blacklists	boolean الافتراضي `true`	اختياري

حقول الرد

الحقل	النوع
`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

طلب مثال

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"

مثال الرد

{
  "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:[email protected]",
        "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": 10,
    "credits_saved": 5,
    "duration_ms": 662,
    "components_called": [
      "dns-security",
      "dnsbl",
      "mx-analysis"
    ],
    "cached_components": [],
    "timestamp": "2026-04-15T10:43:00Z"
  },
  "errors": []
}