# 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](delete.md) 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ı. |

```json
{
  "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

```bash
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`