Bağlantıları listele

GET /v1/connections · izin connections:read

Kimlik bilgisinin ait olduğu ortamın bağlantılarını en yenisinden en eskisine doğru, imleç sayfaları halinde listeler. Ortam her zaman kimlik bilgisinden alınır; diğer ortamların bağlantıları asla döndürülmez. type veya status değiştirilirse, başka bir filtre için verilmiş imleçler geçersiz olur (400 invalid_cursor).

İstek

Sorgu parametreleri:

Alan Tür Zorunlu Açıklama
limit integer hayır 1-100, varsayılan 20.
after / before string hayır list_metadata içindeki opak imleçler; birbirini dışlar.
order string hayır Oluşturulma zamanına göre asc veya desc (varsayılan).
type string hayır Bağlantı türüne göre filtreleyin, örneğin social.
status string hayır Duruma göre filtreleyin: active veya inactive.

Yanıt

200 OK ile data (bağlantılar) ve list_metadata (before, after; o yönde daha fazla sayfa yoksa null) döndürülür. Toplam sayı döndürülmez.

{
  "data": [{
      "id": "conn_0k3v8m1q2x9dz4h7s5t6w0y1ab",
      "key": "google",
      "type": "social",
      "strategy": "google",
      "name": "Google",
      "display_name": "Sign in with Google",
      "status": "inactive",
      "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"
    }],
  "list_metadata": { "before": null, "after": "<cursor>" }
}

Hatalar

HTTP kod Ne zaman
400 invalid_cursor İmleç hatalı biçimlendirilmiş veya başka bir filtre için verilmiş.
422 validation_failed Bir sorgu parametresi geçersiz.
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 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 "https://api.eu.keenauth.com/v1/connections?type=social&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"