Geliştirici Referansı

E-Posta Doğrulaması

E-posta adreslerinin gerçek ve teslim edilebilir olup olmadığını doğrulayın. Kapsamlı doğrulama API'mizle geri dönme oranlarını azaltın, gönderici itibarınızı koruyun ve e-posta teslim edilebilirliğini iyileştirin.

E-Posta Doğrulaması

Fiyatlandırma: Temel Kontrol (2 kredi) · Sözdizimi, MX, geçici, rol tabanlı

GET /v1/email/verify

Sorgu Parametreleri

Parametre	Tür	Açıklama
email gerekli	string	E-posta adreslerinin gerçek olup olmadığını ve teslim edilebilir olduğunu doğrulayın
full isteğe bağlı	boolean Varsayılan `false`	Kullanımdan kaldırıldı ve artık sonucu değiştirmez. SMTP mailbox doğrulaması devre dışı bırakıldı, bu nedenle yanıt onunla veya onsuz aynıdır ve maliyet aynı kalır.

Fiyatlandırma

Kademe	Maliyet	Dahil edilen kontroller
Temel Kontrol	2 kredi	Sözdizimi, MX, geçici, rol tabanlı

Örnek İstek

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

Örnek Yanıt

{
  "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
}

Yanıt Alanları

Alan	Tür
`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

İstek Gövdesi

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

Tek bir API isteğinde 100'e kadar e-postayı doğrulayın.

Örnek İstek

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]"]
  }'

Örnek Yanıt

{
  "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
}

Yanıt Alanları

Alan	Tür
`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