Obtenir le dernier résultat de test d'une connexion

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

Renvoie le résultat du test de connexion le plus récent d'une connexion d'entreprise, datant des dernières 24 heures : statut, raison de l'échec, les noms des attributs ou revendications envoyés par le fournisseur d'identité, le nombre de groupes et les champs utilisateur qui ont reçu une valeur via le mappage d'attributs. Les valeurs d'attributs, l'assertion SAML brute et le jeton ID ne sont jamais enregistrés ni renvoyés. Les résultats de test sont conservés 24 heures. Les lectures ne sont pas auditées.

Requête

Champ Type Obligatoire Description
connection_id chemin oui ID de connexion d'entreprise (conn_…).

Réponse

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"
}
Champ Description
status pending (l'URL n'a pas encore été ouverte ou le fournisseur d'identité n'a pas répondu), passed ou failed.
failure_reason Raison lisible par machine d'un test échoué (par exemple configuration_changed lorsque la connexion a été modifiée pendant le test) ; sinon null.
attribute_names Noms des attributs ou revendications envoyés par le fournisseur d'identité (pas leurs valeurs).
group_count Nombre de groupes reçus.
mapped_fields Champs utilisateur qui ont reçu une valeur via le mappage d'attributs (pas les valeurs).
started_at, completed_at Moment de début du test et moment où la réponse du fournisseur d'identité a été traitée ; completed_at vaut null tant que le statut est pending.

Erreurs

HTTP code Quand
404 not_found La connexion n'existe pas dans cet environnement, n'est pas une connexion d'entreprise, ou n'a aucun résultat de test des dernières 24 heures.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

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