Bağlantıyı sil

DELETE /v1/connections/{connection_id} · izin connections:write

Bağlantıyı siler; kullanıcı verisi silinmez. If-Match zorunludur. Etkin bağlantıdan kimliği olan kullanıcı varsa silme connection_in_use ile başarısız olur; önce bağlantıyı devre dışı bırakın. Bağlantı uygulama bağlantı listelerinden de düşer. Silinen bağlantı 30 gün içinde :restore ile inactive olarak geri yüklenebilir; sonra kalıcı silinir.

İstek

Alan Tür Zorunlu Açıklama
connection_id string evet Bağlantı kimliği (conn_…).
If-Match başlık evet Bağlantının son okunan ETag değeri. Yoksa 428, eskiyse 412.

Yanıt

204 No Content, gövde yok.

Hatalar

HTTP code Ne zaman
404 not_found Bağlantı yok ya da başka bir ortama ait.
409 connection_in_use Kullanıcıların bu etkin bağlantıdan kimlikleri var; önce devre dışı bırakın.
412 precondition_failed If-Match güncel sürümle eşleşmiyor.
428 precondition_required If-Match başlığı yok.
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.
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/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'