Sesión y logout
Enviar el token en las rutas protegidas
Envíe el token en el header Authorization de todas las llamadas protegidas:
export ACCESS_TOKEN='<access_token recibido>'
curl -s \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Accept: application/json' \
"$API_BASE/stcpcore/v2/instances"Cada ruta exige un permiso en el scope del operador. Sin él, la API responde 403.
Expiración
El token es válido durante 60 minutos de forma predeterminada. El tiempo se define en session_duration en el config.json de la API, hasta un máximo de 720 minutos (12 horas).
Cuando una ruta protegida responda 401 (texto Unauthorized), inicie sesión de nuevo y repita la llamada.
Cerrar la sesión
curl -s -X DELETE \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Accept: application/json' \
"$API_BASE/disconnect/api/v3/logout"{
"data": "Logout successful",
"redirect": "<dirección de logout en el proveedor de identidad>"
}Después del logout, el token deja de ser válido.
El campo redirect solo aparece cuando el operador inició sesión por SSO y sso_logout_end_session está habilitado. En ese caso, redirija el navegador a la dirección recibida, para cerrar también la sesión en el proveedor de identidad.