Ottieni l'ultimo risultato del test di una connessione

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

Restituisce il risultato del più recente accesso di prova di una connessione enterprise avvenuto nelle ultime 24 ore: stato, motivo del fallimento, i nomi degli attributi o dei claim inviati dal provider di identità, il numero dei gruppi e i campi utente che hanno ricevuto un valore tramite la mappatura degli attributi. I valori degli attributi, l'asserzione SAML grezza e l'ID token non vengono mai salvati né restituiti. I risultati dei test vengono conservati per 24 ore. Le letture non vengono tracciate.

Richiesta

Campo Tipo Obbligatorio Descrizione
connection_id percorso sì ID della connessione enterprise (conn_…).

Risposta

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"
}
Campo Descrizione
status pending (l'URL non è ancora stato aperto oppure il provider di identità non ha ancora risposto), passed oppure failed.
failure_reason Motivo leggibile dalla macchina di un test fallito (per esempio configuration_changed quando la connessione è stata modificata durante il test); altrimenti null.
attribute_names Nomi degli attributi o dei claim inviati dal provider di identità (non i loro valori).
group_count Numero di gruppi ricevuti.
mapped_fields Campi utente che hanno ricevuto un valore tramite la mappatura degli attributi (non i valori).
started_at, completed_at Quando il test è iniziato e quando la risposta del provider di identità è stata elaborata; completed_at è null finché lo stato è pending.

Errori

HTTP code Quando
404 not_found La connessione non esiste in questo ambiente, non è una connessione enterprise, oppure non ha un risultato di test delle ultime 24 ore.
401 unauthenticated La credenziale è mancante, non valida o revocata.
403 insufficient_permissions La credenziale non ha il permesso richiesto.
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo indicato da Retry-After.
503 service_unavailable Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo indicato da Retry-After.

Esempio

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