Org alan adını şimdi denetle

POST /v1/organization-domains/{domain_id}:verify · izin organization-domains:write

Doğrulamayı hemen çalıştırır. pending ya da unverified alan DNS'te denetlenir: TXT kaydı bulunursa verified olur; bulunmazsa durumunu korur, last_failure_code dolar ve yanıt yine 200'dür. expired ya da revoked alan yeni token'la (yeni TXT değeri) pending'e döner. verified ya da manual alan değişmeden döner. Hücrenin DNS çözücüsü bu kurulumda yapılandırılmamışsa denetim 503 ile reddedilir.

İstek

Alan Tür Zorunlu Açıklama
domain_id path evet Org alan adı kimliği (odm_…).
Idempotency-Key header hayır Yeniden denenen isteği güvenli kılan isteğe bağlı anahtar (16-64 karakter).

İstek gövdesi yoktur.

Yanıt

Alan kaydıyla ve ETag başlığıyla 200 OK.

{
  "id": "odm_01j9xk3m7q8r2s4t6v8w0y2z4c",
  "organization_id": "org_01j9xk3m7q8r2s4t6v8w0y2z4a",
  "domain": "acme.com",
  "status": "verified",
  "verification_method": "dns_txt",
  "txt_record_name": "_akp-verify.acme.com",
  "txt_record_value": "idp-verify=EXAMPLEtokenEXAMPLEtokenEXAMPLEtokenEXAMPLEtok",
  "verification_started_at": "2026-10-12T09:30:00.123456Z",
  "verified_at": "2026-10-12T09:35:00.654321Z",
  "last_checked_at": "2026-10-12T09:35:00.654321Z",
  "unverified_at": null,
  "next_check_at": "2026-10-13T09:35:00.654321Z",
  "last_failure_code": null,
  "capture_mode": "off",
  "sso_routing_enabled": false,
  "created_at": "2026-10-12T09:30:00.123456Z",
  "updated_at": "2026-10-12T09:35:00.654321Z",
  "version": 2
}

Hatalar

HTTP code Ne zaman
404 not_found Bu ortamda bu kimlikle org alan adı yok.
409 conflict Denetim sırasında eşzamanlı bir değişiklik alana dokundu; yeniden deneyin.
409 organization_disabled Org devre dışı.
409 organization_pending_deletion Org self-servis silmeyi bekliyor; önce silmeyi iptal edin.
503 service_unavailable DNS çözücüsü bu kurulumda yapılandırılmamış ya da bir bağımlılık geçici olarak kullanılamıyor.
401 unauthenticated Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.

Örnek

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