POST Logout
Encerra a sessão do usuário autenticado.
Envie o header Authorization: Bearer {accessToken} (token de usuário). Veja Autenticação.
A sessão do token (sid) entra numa lista de sessões encerradas até o vencimento do token e é revogada no provedor de identidade. A partir daí, o próprio accessToken usado na chamada passa a ser recusado com 401 — "Sessão encerrada" — e os WebSockets abertos dessa sessão são derrubados.
Esta rota não limpa o cookie de sessão do navegador: o front faz isso ao redirecionar para a URL de logout do provedor.
Endpoint
POST https://api-dev.imagemais.com.br/api/auth/logout
Corpo da Requisição
Sem corpo. A sessão encerrada é a do próprio token.
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/auth/logout' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'
Respostas
201 Sucesso
Retornado também quando o provedor de identidade não consegue revogar a sessão: a lista de sessões encerradas já vale, e o erro é apenas registrado.
{
"success": true
}
401 Não autenticado
Token ausente, inválido ou de sessão já encerrada.
{
"message": "Sessão encerrada",
"error": "Unauthorized",
"statusCode": 401
}
503 Logout não aplicado
Quando a lista de sessões encerradas não pôde ser gravada: o token atual seguiria válido até vencer, então o cliente deve tentar de novo.
{
"message": "Não foi possível encerrar a sessão. Tente novamente em instantes.",
"error": "Service Unavailable",
"statusCode": 503
}