Özel alan adını kaldırma

DELETE /v1/custom-domains/{custom_domain_id} · izin custom-domains:write

Bir özel alan adını kaldırır: durumu released olur, o alan adında oturum açma durur ve ad 30 gün boyunca karantinada kalır (başka hiçbir ortam bunu ekleyemez). Birincil alan adı ve ortamın veren kuruluşu olarak kullanılan alan adı kaldırılamaz; önce başka bir alan adını birincil yapın. Zaten serbest bırakılmış bir alan adını kaldırmak yalnızca platform kaydındaki serbest bırakmayı tekrarlar.

İstek

Alan Tür Zorunlu Açıklama
custom_domain_id string evet Özel alan adı kimliği (cdom_…).
If-Match header evet Zorunlu. Alan adının ETag değeri; eksikse 428, eşleşmiyorsa 412.

İstek gövdesi yok.

Yanıt

204 No Content.

Hatalar

HTTP code Ne zaman
404 not_found Özel alan adı yok veya başka bir ortama ait.
409 custom_domain_in_use Alan adı birincil alan adı veya ortamın veren kuruluşu.
409 domain_in_use_by_rp_id Alan adı bir bağlantının Passkey rpId değeri veya devam eden bir rpId geçişinin önceki rpId değeri; önce rpId değerini Passkey rpId değerini değiştirin ile taşıyın.
412 precondition_failed If-Match, alan adının mevcut sürümüyle eşleşmiyor.
428 precondition_required If-Match eksik.
503 service_unavailable Platform alan adı kaydı veya ortamın veren kuruluş bilgisi geçici olarak kullanılamıyor.
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 tekrar deneyin.

Örnek

curl -X DELETE https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3"'