Bağlantının son test sonucunu getir

GET /v1/connections/{connection_id}/test-results/latest · izin connections:write

Kurumsal bağlantının son 24 saatteki en yeni test girişinin sonucunu döndürür: durum, başarısızlık nedeni, kimlik sağlayıcının gönderdiği özniteliklerin ya da claim'lerin adları, grup sayısı ve öznitelik eşlemesiyle değer alan kullanıcı alanları. Öznitelik değerleri, ham SAML assertion'ı ve ID token hiçbir zaman saklanmaz ve döndürülmez. Test sonuçları 24 saat tutulur. Okumalar audit'e yazılmaz.

İstek

Alan Tür Zorunlu Açıklama
connection_id yol evet Kurumsal bağlantı kimliği (conn_…).

Yanıt

200 OK:

{
  "test_id": "conntest_01j9xr4a6b8c0d2e4f6g8h0j2k",
  "status": "passed",
  "failure_reason": null,
  "attribute_names": ["email", "given_name", "groups"],
  "group_count": 2,
  "mapped_fields": ["email", "given_name"],
  "started_at": "2026-10-20T10:00:00Z",
  "completed_at": "2026-10-20T10:01:12Z"
}
Alan Açıklama
status pending (URL henüz açılmadı ya da kimlik sağlayıcı yanıt vermedi), passed ya da failed.
failure_reason Başarısız testin makine nedeni (örneğin test sırasında bağlantı değiştiyse configuration_changed); aksi halde null.
attribute_names Kimlik sağlayıcının gönderdiği özniteliklerin ya da claim'lerin adları (değerleri değil).
group_count Gelen grup sayısı.
mapped_fields Öznitelik eşlemesiyle değer alan kullanıcı alanları (değerleri değil).
started_at, completed_at Testin başladığı ve kimlik sağlayıcı yanıtının işlendiği an; pending iken completed_at null'dır.

Hatalar

HTTP code Ne zaman
404 not_found Bağlantı bu ortamda yok, kurumsal bağlantı değil ya da son 24 saatte test sonucu 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 "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/test-results/latest" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth connections test-results latest conn_01j9xp6q0r1s5t7v9w1x3y5z7b