E-posta gönderen alan adını al

GET /v1/email-sender-domains/{sender_domain_id} · izin email-sender-domains:read · tüm planlar

Bir gönderen alan adını döndürür: durumunu, son DNS denetiminin sonuçlarını ve yayımlanacak DNS kayıtlarını. ETag üstbilgisi sürümü taşır; alan adını sildiğinizde bunu If-Match olarak gönderin.

İstek

Alan Tür Zorunlu Açıklama
sender_domain_id string evet Gönderen alan adı kimliği (sdom_…).

Gövde yok.

Yanıt

200 OK ile gönderen alan adı ve sürümüne eşit ETag döner.

Alan Tür Açıklama
id string Gönderen alan adı kimliği (sdom_…).
domain string IDNA 2008 A-etiketi olarak alan adı, küçük harfli, sonunda nokta olmadan.
status string pending_dns (DNS kayıtları bekleniyor), verified (gönderime hazır), degraded (kayıtlar 72 saattir başarısız; ortam platform gönderimine geri döndü) veya disabled (platform tarafından devre dışı bırakıldı).
active_selector string İmzalama için kullanılan DKIM seçici: akp1 veya akp2.
dkim_status string or null İki DKIM CNAME kaydının son denetimi (ikisinin en kötüsü): ok, missing, wrong_target veya lookup_failed; ilk denetimden önce null.
return_path_status string or null Return-path CNAME kaydının son denetimi, aynı kodlarla; ilk denetimden önce null.
dmarc_alignment string or null Son denetimin DMARC sonucu: aligned, not_aligned, no_record, invalid_record veya lookup_failed. DMARC zorunlu değildir.
last_checked_at string or null Son denetim zamanı.
failing_since string or null verified bir alan adının ilk başarısız denetimi; 72 saate ulaştığında alan adı degraded olur.
degraded_since string or null Alan adının degraded olduğu zaman.
records array Yayımlanacak DNS kayıtları: type (CNAME veya TXT), name, value ve required. İki DKIM CNAME kaydı ve return-path CNAME kaydı zorunludur; son denetimde _dmarc kaydı bulunamadıysa required: false ile bir DMARC önerisi (v=DMARC1; p=none) eklenir.
version integer Alan adı sürümü, ETag ile aynıdır; kontroller dahil her yazmada artar.
created_at string Oluşturulma zamanı.
updated_at string Son değişiklik zamanı. 
{
  "id": "sdom_01k7r9m3q5t8v2w4x6y8z0a2b4",
  "domain": "mail.example.com",
  "status": "pending_dns",
  "active_selector": "akp1",
  "dkim_status": null,
  "return_path_status": null,
  "dmarc_alignment": null,
  "last_checked_at": null,
  "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
    }
  ],
  "version": 1,
  "created_at": "2026-10-19T09:00:00Z",
  "updated_at": "2026-10-19T09:00:00Z"
}

Hatalar

HTTP code Ne zaman
404 not_found Gönderen alan adı yok, başka bir ortama ait veya kimlik biçimi hatalı.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisi gerekli izne sahip değil.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

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

CLI: keenauth email-sender-domains get sdom_01k7r9m3q5t8v2w4x6y8z0a2b4