Sessão e logout
Enviar o token nas rotas protegidas
Envie o token no header Authorization de todas as chamadas protegidas:
export ACCESS_TOKEN='<access_token recebido>'
curl -s \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Accept: application/json' \
"$API_BASE/stcpcore/v2/instances"Cada rota exige uma permissão no scope do operador. Sem ela, a API responde 403.
Expiração
O token vale 60 minutos por padrão. O tempo é definido em session_duration no config.json da API, até o máximo de 720 minutos (12 horas).
Quando uma rota protegida responder 401 (texto Unauthorized), faça um novo login e repita a chamada.
Encerrar a sessão
curl -s -X DELETE \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Accept: application/json' \
"$API_BASE/disconnect/api/v3/logout"{
"data": "Logout successful",
"redirect": "<endereço de logout no provedor de identidade>"
}Depois do logout, o token deixa de ser válido.
O campo redirect só aparece quando o operador entrou por SSO e sso_logout_end_session está habilitado. Nesse caso, redirecione o navegador para o endereço recebido, para encerrar também a sessão no provedor de identidade.