# Letztes Testergebnis einer Verbindung abrufen

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

Gibt das Ergebnis der jüngsten [Testanmeldung](test.md) einer Enterprise-Verbindung aus den letzten 24 Stunden zurück: Status, Fehlergrund, die **Namen** der Attribute oder Claims, die der Identity Provider gesendet hat, die Anzahl der Gruppen und die Benutzerfelder, die über die Attributzuordnung einen Wert erhalten haben. Attributwerte, die rohe SAML-Assertion und das ID-Token werden nie gespeichert oder zurückgegeben. Testergebnisse werden 24 Stunden aufbewahrt. Lesezugriffe werden nicht auditiert.

## Anfrage

| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `connection_id` | Pfad | ja | ID der Enterprise-Verbindung (`conn_…`). |

## Antwort

`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"
}
```

| Feld | Beschreibung |
|---|---|
| `status` | `pending` (die URL wurde noch nicht geöffnet oder der Identity Provider hat noch nicht geantwortet), `passed` oder `failed`. |
| `failure_reason` | Maschinenlesbarer Grund eines fehlgeschlagenen Tests (z. B. `configuration_changed`, wenn die Verbindung während des Tests geändert wurde); sonst `null`. |
| `attribute_names` | Namen der Attribute oder Claims, die der Identity Provider gesendet hat (nicht deren Werte). |
| `group_count` | Anzahl der erhaltenen Gruppen. |
| `mapped_fields` | Benutzerfelder, die über die Attributzuordnung einen Wert erhalten haben (nicht die Werte). |
| `started_at`, `completed_at` | Wann der Test gestartet wurde und wann die Antwort des Identity Providers verarbeitet wurde; `completed_at` ist solange `null`, wie der Status `pending` ist. |

## Fehler

| HTTP | code | Wann |
|---|---|---|
| 404 | `not_found` | Die Verbindung existiert in dieser Umgebung nicht, ist keine Enterprise-Verbindung oder hat kein Testergebnis aus den letzten 24 Stunden. |
| 401 | `unauthenticated` | Die Anmeldedaten fehlen, sind ungültig oder widerrufen. |
| 403 | `insufficient_permissions` | Den Anmeldedaten fehlt die erforderliche Berechtigung. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; wiederholen Sie nach der Frist aus `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie nach der Frist aus `Retry-After`. |

## Beispiel

```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
```