E-posta gönderen alan adını doğrulayın

POST /v1/email-sender-domains/{sender_domain_id}:verify · izin email-sender-domains:write · tüm planlar

Alan adının DNS kayıtlarını hemen kontrol eder ve güncellenmiş alan adını döndürür. Platform ayrıca her alan adını aynı kurallarla her gün kontrol eder:

İki DKIM CNAME kaydı ve dönüş yolu CNAME kaydı doğru hedeflere işaret ettiğinde, pending_dns veya degraded durumundaki bir alan adı verified olur.
verified durumundaki bir alan adı 72 saat boyunca başarısız olmaya devam ederse degraded olur ve kayıtlar düzeltilene kadar ortamın e-postası platform alan adından gönderilir.
DMARC, dmarc_alignment içinde raporlanır ancak zorunlu değildir. _dmarc kaydı yoksa records önerilen bir kayıt içerir.

Platform tarafından devre dışı bırakılan bir alan adı kontrol edilemez. Her ortam saatte 20 kontrol çalıştırabilir.

İstek

Alan	Tür	Zorunlu	Açıklama
`sender_domain_id`	string	evet	Gönderen alan adı kimliği (`sdom_…`).
`Idempotency-Key`	header	hayır	Aynı anahtarla yapılan tekrarlanan istek için aynı yanıtı yeniden oynatır.

İstek gövdesi yoktur.

Yanıt

Kontrol edilen gönderen alan adı ve yeni sürümüne ayarlanmış ETag ile 200 OK. Alanlar E-posta gönderen alan adını alın sayfasında açıklanmıştır.

{
  "id": "sdom_01k7r9m3q5t8v2w4x6y8z0a2b4",
  "domain": "mail.example.com",
  "status": "verified",
  "active_selector": "akp1",
  "dkim_status": "ok",
  "return_path_status": "ok",
  "dmarc_alignment": "no_record",
  "last_checked_at": "2026-10-19T09:30:00Z",
  "failing_since": null,
  "degraded_since": null,
  "records": [
    {
      "type": "CNAME",
      "name": "akp1._domainkey.mail.example.com",
      "value": "akp1.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
      "required": true
    },
    {
      "type": "CNAME",
      "name": "akp2._domainkey.mail.example.com",
      "value": "akp2.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
      "required": true
    },
    {
      "type": "CNAME",
      "name": "rp.mail.example.com",
      "value": "rp.eu.mail.keenauth.app",
      "required": true
    },
    {
      "type": "TXT",
      "name": "_dmarc.mail.example.com",
      "value": "v=DMARC1; p=none",
      "required": false
    }
  ],
  "version": 2,
  "created_at": "2026-10-19T09:00:00Z",
  "updated_at": "2026-10-19T09:30:00Z"
}

Hatalar

HTTP	code	Ne zaman
404	`not_found`	Gönderen alan adı yoksa, başka bir ortama aitse veya kimlik hatalı biçimdeyse.
409	`conflict`	Alan adı platform tarafından devre dışı bırakılmışsa.
429	`rate_limited`	Ortam son bir saatte 20 kontrol çalıştırmışsa veya genel hız sınırı aşılmışsa; `Retry-After` süresinden sonra yeniden deneyin.
401	`unauthenticated`	Kimlik bilgisi eksik, geçersiz veya iptal edilmişse.
403	`insufficient_permissions`	Kimlik bilgisi gerekli izne sahip değilse.
503	`service_unavailable`	Bir bağımlılık geçici olarak kullanılamıyorsa; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

curl -X POST https://api.eu.keenauth.com/v1/email-sender-domains/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4:verify \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth email-sender-domains verify sdom_01k7r9m3q5t8v2w4x6y8z0a2b4