> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ar/docs/recipe-email-deliverability

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

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

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

GET /v1/recipes/email-deliverability الرصيد: 10

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

| المعامل | النوع | مطلوب |
| --- | --- | --- |
| domain | string | مطلوب |
| dkim_selectors | string | اختياري |
| check_blacklists | boolean الافتراضي `true` | اختياري |
| dry_run | string القيم المسموحة `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.status` | string |
| `data.blacklist_status.listed_on[]` | array |
| `data.blacklist_status.unknown_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 |

#### طلب مثال

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/recipes/email-deliverability?domain=example.com&dkim_selectors=default%2Cgoogle&check_blacklists=true"
```

```javascript
const response = await fetch("https://domscan.net/v1/recipes/email-deliverability?domain=example.com&dkim_selectors=default%2Cgoogle&check_blacklists=true", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/recipes/email-deliverability?domain=example.com&dkim_selectors=default%2Cgoogle&check_blacklists=true",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/recipes/email-deliverability?domain=example.com&dkim_selectors=default%2Cgoogle&check_blacklists=true", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/recipes/email-deliverability?domain=example.com&dkim_selectors=default%2Cgoogle&check_blacklists=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### مثال الرد

```json
{
  "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": {
      "status": "clean",
      "listed_on": [],
      "unknown_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": []
}
```

#### رموز حالة HTTP

- `200` OK
- `400` طلب غير صالح
- `401` غير مصرح
- `402` الدفع مطلوب
- `429` طلبات كثيرة جداً
