# 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](get.md) sayfasında açıklanmıştır.

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

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