Obtener la transacción de inicio de sesión actual
GET /fapi/v1/transactions/current · llamado desde el host de inicio de sesión del entorno
Devuelve la transacción a la que apunta la cookie __Host-idp_ltx, incluido su estado y los pasos que pueden ejecutarse a continuación.
Úsela para reanudar una página de inicio de sesión después de recargarla.
Solicitud
Encabezados:
| Encabezado | Obligatorio | Descripción |
|---|---|---|
Idp-Client |
sí | Identificador del SDK, <package>/<version> (<runtime>/<version>). |
El navegador envía automáticamente la cookie de la transacción.
Respuesta
200 OK con el objeto de transacción (schema_version, state, next_steps, csrf_token, expires_at). Cada respuesta
incluye Cache-Control: no-store.
Una transacción que pide al usuario vincular una conexión empresarial con una cuenta existente también incluye account_link
(connection_name, organization_name); consulte Ejecutar un paso de inicio de sesión. La página alojada
lo obtiene con resume=1 y la continúa en lugar de crear una nueva transacción. Hace lo mismo después de un
inicio de sesión empresarial que todavía necesita un segundo factor (second_factor_pending) o un registro (enrollment_pending).
Transacciones sin interfaz vinculadas a DPoP
En una transacción iniciada con un encabezado DPoP, envíe una nueva prueba con la misma clave (htm GET, htu esta URL); el
servidor devuelve la transacción vigente más reciente vinculada a esa clave. El código de autorización nunca se devuelve aquí.
Errores
| Estado | Código | Cuándo |
|---|---|---|
| 400 | malformed_request |
Falta Idp-Client. |
| 410 | transaction_expired |
No hay cookie, la cookie no es válida o la transacción ha finalizado. |
| 401 | invalid_dpop_proof |
La prueba DPoP no es válida o se reutilizó. |
Ejemplo
curl https://example.keenauth.app/fapi/v1/transactions/current \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Datos personales
Este endpoint trata datos personales: perfil del usuario final. Datos personales en las API de KeenAuth describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.