مرجع المطورين
التحقق من البريد الإلكتروني
باستخدام DomScan 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_lookup_failed |
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.dnsbl_status |
string |
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 |