Bir bağlantıyı etkinleştirin

POST /v1/connections/{connection_id}:activate · izin connections:write

Bağlantının status değerini active olarak ayarlar. İstek gövdesi isteğe bağlıdır ve alanı yoktur. İşlem idempotenttir: bağlantı zaten bu duruma sahipse hiçbir şey yazılmaz, sürüm değişmez ve mevcut bağlantı döndürülür. If-Match kullanılmaz; bağlantıyı aynı anda başka bir yazıcı değiştirirse çağrı birkaç kez yeniden denenir. Bir enterprise (SAML veya OIDC) bağlantısını etkinleştirmek, son 24 saat içinde mevcut protokol yapılandırmasını ve bağlantının sahip olacağı allowed_email_domains değerlerini kapsayan başarılı bir test girişi gerektirir; aksi halde çağrı 409 connection_test_required döndürür ve hiçbir şey yazılmaz. Kontrol yapılamazsa bağlantı etkinleştirilmez ve çağrı 503 döndürür. Diğer bağlantı türleri kontrol edilmez.

İstek

Alan Tür Zorunlu Açıklama
connection_id string evet Bağlantı tanımlayıcısı (conn_…).
Idempotency-Key header hayır Yeniden denenen isteği güvenli hale getiren isteğe bağlı anahtar (16-64 karakter).

Gövde isteğe bağlıdır; gönderilirse {} olmalıdır.

Yanıt

Bağlantı ve ETag değeriyle birlikte 200 OK.

{
  "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
  "key": "google",
  "type": "social",
  "strategy": "google",
  "name": "Google",
  "display_name": "Sign in with Google",
  "status": "active",
  "org_id": null,
  "allowed_email_domains": [],
  "allow_external_domains": false,
  "jit_mode": null,
  "email_trust": null,
  "default_role_ids": [],
  "trust_idp_mfa": null,
  "allow_idp_initiated": null,
  "idp_initiated_default_application_id": null,
  "idp_initiated_allowed_application_ids": [],
  "settings": {},
  "created_at": "2026-10-05T09:30:00.123456Z",
  "updated_at": "2026-10-05T09:30:00.123456Z"
}

Hatalar

HTTP kod Ne zaman
400 unknown_field İstek gövdesi bir alan içeriyor.
404 not_found Bağlantı mevcut değil ya da başka bir ortama ait.
409 connection_test_required Bir enterprise bağlantısının son 24 saat içinde mevcut yapılandırmasıyla yapılmış başarılı bir testi yok. Bir test girişi çalıştırın, ardından yeniden deneyin.
412 precondition_failed Bağlantı eşzamanlı olarak değişmeye devam etti; yeniden deneyin.
401 unauthenticated Kimlik bilgisi eksik, geçersiz ya da 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 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 POST https://api.eu.keenauth.com/v1/connections/conn_0k3v8m1q2x9dz4h7s5t6w0y1ab:activate \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"