POST/api/auth/sso/exchange
Último paso de un inicio de sesión SSO (SAML/OIDC): cambia el código de un solo uso de la redirección por un token de acceso y un token de actualización.
Tras iniciar sesión en el proveedor de identidad, Zentor App redirige el navegador con un código de un solo uso en el parámetro de consulta `sso_code`. Envíe este código en el campo `code`. La respuesta contiene `token` y `refreshToken`, como en un inicio de sesión normal. Cada código es válido solo una vez y durante poco tiempo. Un código ya usado, caducado o inválido da como resultado 400 `SSO_EXCHANGE_INVALID`; el usuario reinicia entonces el inicio de sesión SSO. Por ello, la llamada no es idempotente.
Descripción general
Llamada: POST /api/auth/sso/exchange. Este endpoint pertenece al grupo «Autenticación» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: code (body). Casos de error documentados: 400 SSO_EXCHANGE_INVALID. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.
Autenticación y seguridad
No se requiere autenticación
Idempotente: No
Parámetros
code(body, string, obligatorio)— Código de un solo uso de la redirección SSOSolicitud de ejemplo
{"code":"<Código de un solo uso del redirect de callback SSO>"}Respuesta de ejemplo
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Códigos de error
400 SSO_EXCHANGE_INVALID — El código es inválido, ya se ha usado o ha caducado.Comportamiento verificado
Un código inválido devuelve 400 `SSO_EXCHANGE_INVALID`. El caso de éxito requiere un inicio de sesión completo en el proveedor de identidad configurado.
Autenticación
POST /api/auth/loginInicia la sesión de un usuario con dirección de correo o nombre de usuario y contraseña, y emite un token de acceso (JWT) y un token de actualización (refresh token).POST /api/auth/refreshCambia un token de actualización válido por un nuevo par de token de acceso y token de actualización.POST /api/auth/forgot-passwordInicia el restablecimiento de una contraseña: si existe una cuenta con la dirección de correo indicada, recibe un correo con un enlace para restablecerla.POST /api/auth/reset-passwordEstablece una nueva contraseña con el token de restablecimiento del correo de restablecimiento.