تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.
يستخدمه أشخاص في شركات مميزة
إشارات ثقة قبل التكامل
توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.
روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.
تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.
ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.
ما الذي تساعدك هذه الواجهة على إطلاقه
استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.
ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.
استبدل عمليات البحث اليدوية المتكررة بمهام مجدولة وتنبيهات وخطوات تحقيق قابلة للإعادة.
استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.
زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.
سير عمل التكامل
مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.
أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.
ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.
استخدم رموز الحالة وتكاليف الاعتمادات وحقول الاستجابة لبناء إعادة المحاولة والسجلات والتنبيهات.
عدة المطور
انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.
خريطة المعلمات والاستجابة
راجع المدخلات وحقول الإخراج ورموز الحالة قبل توصيل نقطة النهاية بعميلك.
المعامل
مثال الرد
رموز حالة HTTP
نقاط النهاية
/v1/email/compliance
إشارات ثقة قبل التكامل
توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.
روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.
تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.
ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.
ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.
الميزات الرئيسية
GET /v1/email/compliance
domain, providers, selectors
200, 400, 401, 402, 429
6 / المصادقة مطلوبة
طلب مثال
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/compliance?domain=example.com&providers=google,microsoft&selectors=google,selector1"
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/email/compliance?domain=example.com&providers=google"
مثال الرد
{
"domain": "example.com",
"status": "warn",
"score": 82,
"grade": "B",
"provider_readiness": {
"google": {
"provider": "google",
"display_name": "Google/Gmail bulk sender readiness",
"status": "pass",
"dns_visible_status": "pass",
"requirements": [
{
"id": "google_spf",
"label": "SPF must be configured for bulk senders",
"status": "pass",
"severity": "critical",
"category": "dns",
"evidence": "SPF policy: softfail",
"recommendation": "Publish one valid SPF record that covers every approved sending platform."
},
{
"id": "google_alignment",
"label": "From domain must align with either SPF or DKIM on live messages",
"status": "unknown",
"severity": "high",
"category": "message",
"evidence": "Alignment requires Authentication-Results from a real sent message",
"recommendation": "Send a test message and verify SPF or DKIM alignment."
}
],
"verification_required": [
"From domain must align with either SPF or DKIM on live messages",
"Outbound mail must be transmitted over TLS"
],
"notes": [
"Status is based on DNS-visible controls. Live sending requirements still need message-header and sender-platform verification."
]
},
"microsoft": {
"provider": "microsoft",
"display_name": "Microsoft Outlook.com high-volume sender readiness",
"status": "pass",
"dns_visible_status": "pass",
"requirements": [],
"verification_required": [
"DMARC must align with either SPF or DKIM"
],
"notes": [
"Status is based on DNS-visible controls. Live sending requirements still need message-header and sender-platform verification."
]
}
},
"summary": {
"authentication": {
"spf": {
"status": "pass",
"record": "v=spf1 include:_spf.example.com ~all",
"policy": "softfail",
"lookup_count": 3,
"lookup_limit_exceeded": false
},
"dkim": {
"status": "pass",
"selectors_checked": [
"google",
"selector1",
"sendgrid"
],
"selectors_found": [
"google"
],
"valid_selector_count": 1,
"weak_selector_count": 0,
"revoked_selector_count": 0,
"providers_detected": [
"Google Workspace"
]
},
"dmarc": {
"status": "warn",
"record": "v=DMARC1; p=none; rua=mailto:[email protected]",
"policy": "none",
"subdomain_policy": null,
"percentage": 100,
"rua": [
"mailto:[email protected]"
],
"alignment_mode": {
"spf": null,
"dkim": null
}
}
},
"transport": {
"mta_sts": {
"status": "pass",
"mode": "enforce",
"policy_fetch_ok": true,
"policy_matches_mx": true
},
"tls_rpt": {
"status": "pass",
"rua": [
"mailto:[email protected]"
]
},
"mx_records": [
"aspmx.l.google.com"
],
"client_access_secure_services": 1
},
"dns_security": {
"dnssec": "pass",
"caa": "pass",
"zone_transfer": "pass",
"authoritative_consistency": "pass",
"blacklist": "pass"
},
"brand_trust": {
"bimi": "unknown",
"vmc": "unknown"
}
},
"action_items": [
{
"priority": "medium",
"category": "authentication",
"title": "Move DMARC beyond monitoring mode",
"detail": "DMARC is valid but still uses p=none.",
"fix": "After reviewing aggregate reports, move to p=quarantine or p=reject."
}
],
"evidence": {
"email_auth": {
"spf": {
"record": "v=spf1 include:_spf.example.com ~all"
},
"dmarc": {
"record": "v=DMARC1; p=none; rua=mailto:[email protected]"
}
},
"dns_security": {
"security_score": 86,
"security_grade": "B"
}
},
"proxy": {
"configured": true,
"enriched": true,
"checks": [
"spf_walk",
"mail_policies",
"dkim_audit",
"bimi_audit"
]
},
"limitations": [
"DNS-visible checks cannot prove live message-level SPF, DKIM, DMARC alignment, RFC 5322 formatting, spam rate, or one-click unsubscribe behavior."
],
"checked_at": "2026-04-26T12:00:00Z",
"check_duration_ms": 642
}
الأسئلة الشائعة
يغطي هذا الدليل 1 من نقاط النهاية العامة: GET /v1/email/compliance.
نعم. أرسل مفتاح API الخاص بك باستخدام `X-API-Key` أو رأس `Authorization: Bearer` عند استدعاء امتثال البريد الإلكتروني.
تستخدم الطلبات في هذه الأدلة 6 من الاعتمادات حسب نقطة النهاية. بالنسبة إلى نقاط النهاية المجمعة، تُحسب الاعتمادات وفق المعدل القياسي لكل عنصر.
استخدم الوثائق الكاملة لـ امتثال البريد الإلكتروني لمراجعة تفاصيل المعلمات وملاحظات المصادقة ونقاط النهاية ذات الصلة في عائلة API نفسها.
الأدوات والموارد ذات الصلة
رموز حالة HTTP
نوثّق رموز حالة HTTP التي يجب على عميلك التعامل معها حتى تتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات غير الموجودة وأعطال الخدمة الخارجية.
نجح الطلب
معلمات غير صالحة
مفتاح API أو الجلسة مفقود أو غير صالح.
لا توجد أرصدة كافية لتنفيذ هذا الطلب.
تم تجاوز حد المعدل
ابدأ مجانًا مع 10,000 رصيد شهريًا. استخدم أي API عامة وأضف أرصدة فقط عندما تحتاج إليها.