# 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](test.md) 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`:

```json
{
  "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

```bash
curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/test-results/latest" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

```bash
keenauth connections test-results latest conn_01j9xp6q0r1s5t7v9w1x3y5z7b
```