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

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

تحقق من أن عناوين البريد الإلكتروني حقيقية وقابلة للتسليم. قلل bounce rates، واحمِ sender reputation، وحسّن email deliverability باستخدام API التحقق الشامل الخاص بنا.

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

التسعير: فحص أساسي (رصيدان) · الصياغة، MX، المؤقت، المعتمد على الدور

GET /v1/email/verify

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

المعامل	النوع	Description
email مطلوب	string	تحقق مما إذا كانت عناوين البريد الإلكتروني حقيقية وقابلة للتسليم
full اختياري	boolean الافتراضي `false`	مُستهلك ولم يعد يغير النتيجة. تم إيقاف التحقق من صندوق البريد SMTP، لذلك الاستجابة متطابقة معه أو بدونه والتكلفة تبقى كما هي.

التسعير

الفئة	التكلفة	عدد الفحوصات المشمولة
فحص أساسي	رصيدان	الصياغة، MX، المؤقت، المعتمد على الدور

طلب مثال

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/email/[email protected]"

مثال الرد

{
  "email": "[email protected]",
  "normalized_email": "[email protected]",
  "result": "valid",
  "result_detail": "mx_verified",
  "risk": "low",
  "confidence": 0.62,
  "decision": "accept",
  "reasons": ["mx_found", "not_disposable", "mailbox_not_checked", "redundant_mx_records"],
  "verification": {
    "syntax_valid": true,
    "mx_found": true,
    "mx_records": ["mx1.company.com", "mx2.company.com"],
    "smtp_verified": null,
    "mailbox_exists": null,
    "catch_all": null,
    "full_inbox": null,
    "smtp_provider": null
  },
  "classification": {
    "disposable": false,
    "role_based": false,
    "free_provider": false,
    "provider": null
  },
  "reputation": {
    "dnsbl_listed": false,
    "threat_level": null
  },
  "quality": {
    "score": 100,
    "grade": "A",
    "flags": []
  },
  "signals": {
    "domain_profile": { "status": "pass", "reason": "clean_domain_profile" },
    "local_part": { "status": "pass", "reason": "clean_local_part" },
    "mx_redundancy": { "status": "pass", "reason": "redundant_mx_records" },
    "domain_authentication": { "status": "pass", "reason": "domain_authentication_strong" },
    "toxicity": { "status": "pass", "reason": "not_toxic" }
  },
  "recommendation": {
    "signup": "allow",
    "marketing": "send",
    "cold_outreach": "send"
  },
  "deliverability": {
    "status": "deliverable",
    "sub_status": "mx_verified",
    "safe_to_send": true,
    "is_toxic": false,
    "is_gibberish": false
  },
  "tier": "basic",
  "credits_used": 2
}

حقول الرد

الحقل	النوع
`email`	string
`normalized_email`	string
`result`	string
`result_detail`	string
`message`	string \| null
`risk`	string
`confidence`	number
`confidence_level`	string
`decision`	string
`reasons[]`	string[]
`verification`	object
`verification.syntax_valid`	boolean
`verification.mx_found`	boolean
`verification.null_mx`	boolean
`verification.mx_records[]`	string[]
`verification.smtp_verified`	boolean \| null
`verification.mailbox_exists`	boolean \| null
`verification.catch_all`	boolean \| null
`verification.full_inbox`	boolean \| null
`verification.smtp_provider`	string \| null
`classification`	object
`classification.disposable`	boolean
`classification.disposable_confidence`	string \| null
`classification.role_based`	boolean
`classification.role_type`	string \| null
`classification.free_provider`	boolean
`classification.provider`	string \| null
`reputation`	object
`reputation.dnsbl_listed`	boolean
`reputation.threat_level`	string \| null
`quality`	object
`quality.score`	integer
`quality.grade`	string
`quality.flags[]`	string[]
`signals`	object
`evidence`	object
`evidence.mx_records[]`	string[]
`evidence.provider`	string \| null
`evidence.checked_via[]`	string[]
`evidence.normalized_parts`	object
`evidence.normalized_parts.local_part`	string
`evidence.normalized_parts.domain`	string
`evidence.normalized_parts.base_local_part`	string
`evidence.normalized_parts.tag`	string \| null
`evidence.domain_profile`	object
`evidence.domain_profile.tld`	string \| null
`evidence.domain_profile.label_count`	integer
`evidence.domain_profile.reserved`	boolean
`evidence.domain_profile.domain_literal`	boolean
`evidence.domain_profile.punycode`	boolean
`evidence.domain_profile.suspicious_reasons[]`	string[]
`evidence.domain_authentication`	object
`evidence.domain_authentication.checked`	boolean
`evidence.domain_authentication.status`	string
`evidence.domain_authentication.spf`	object
`evidence.domain_authentication.spf.exists`	boolean
`evidence.domain_authentication.spf.policy`	string
`evidence.domain_authentication.spf.record`	string \| null
`evidence.domain_authentication.dmarc`	object
`evidence.domain_authentication.dmarc.exists`	boolean
`evidence.domain_authentication.dmarc.policy`	string
`evidence.domain_authentication.dmarc.record`	string \| null
`evidence.domain_authentication.dmarc.percentage`	integer \| null
`evidence.domain_authentication.mta_sts`	object
`evidence.domain_authentication.mta_sts.exists`	boolean
`evidence.domain_authentication.mta_sts.record`	string \| null
`evidence.domain_authentication.tls_rpt`	object
`evidence.domain_authentication.tls_rpt.exists`	boolean
`evidence.domain_authentication.tls_rpt.record`	string \| null
`evidence.domain_authentication.issues[]`	string[]
`recommendation`	object
`recommendation.signup`	string
`recommendation.marketing`	string
`recommendation.cold_outreach`	string
`deliverability`	object
`deliverability.status`	string
`deliverability.sub_status`	string
`deliverability.safe_to_send`	boolean
`deliverability.mailbox_checked`	boolean
`deliverability.smtp_confirmed`	boolean
`deliverability.domain_accepts_mail`	boolean
`deliverability.accepts_all`	boolean \| null
`deliverability.is_role`	boolean
`deliverability.is_free_provider`	boolean
`deliverability.is_disposable`	boolean
`deliverability.is_toxic`	boolean
`deliverability.is_no_reply`	boolean
`deliverability.is_gibberish`	boolean
`suggestions`	object
`suggestions.did_you_mean`	string \| null
`limitations[]`	string[]
`tier`	string
`credits_used`	integer
`verified_at`	string

POST /v1/email/verify/bulk

نص الطلب

{
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}

تحقق من ما يصل إلى 100 بريد إلكتروني في طلب API واحد.

طلب مثال

curl -H "X-API-Key: your-api-key" -X POST "https://domscan.net/v1/email/verify/bulk" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["[email protected]", "[email protected]"]
  }'

مثال الرد

{
  "results": [
    {
      "email": "[email protected]",
      "result": "valid",
      "result_detail": "mx_verified",
      "tier": "basic",
      "credits_used": 2
    },
    {
      "email": "[email protected]",
      "result": "valid",
      "result_detail": "role_based_address",
      "tier": "basic",
      "credits_used": 2
    }
  ],
  "summary": {
    "total": 2,
    "valid": 2,
    "invalid": 0,
    "risky": 0,
    "unknown": 0,
    "pending": 0
  },
  "credits_used": 4
}

حقول الرد

الحقل	النوع
`results[]`	object[]
`results[]`	object
`summary`	object
`summary.total`	integer
`summary.valid`	integer
`summary.invalid`	integer
`summary.risky`	integer
`summary.unknown`	integer
`summary.pending`	integer
`credits_used`	integer