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

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

Bir gönderen alan adını siler. E-posta teslim yapılandırmasının hâlâ kullandığı bir alan adı silinemez: önce e-posta sağlayıcısını başka bir moda geçirin. Silmeden sonra alan adının DNS kayıtlarını kaldırabilirsiniz.

İstek

Alan Tür Zorunlu Açıklama
sender_domain_id string evet Gönderen alan adı kimliği (sdom_…).
If-Match başlık evet Alan adının ETag değeri; * herhangi bir sürümle eşleşir. Yoksa 428, eşleşmezse 412.

İstek gövdesi yoktur.

Yanıt

204 No Content.

Hatalar

HTTP code Ne zaman
404 not_found Gönderen alan adı yok, başka bir ortama ait veya kimlik hatalı biçimde.
409 conflict E-posta teslim yapılandırması alan adını kullanıyor (platform_managed_domain). Önce e-posta sağlayıcısını başka bir moda ya da alan adına geçirin.
412 precondition_failed If-Match, alan adının mevcut sürümüyle eşleşmiyor.
428 precondition_required If-Match eksik.
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yok.
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 -X DELETE https://api.eu.keenauth.com/v1/email-sender-domains/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'

CLI: keenauth email-sender-domains delete sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 --if-match '"2"'