Skip to main content

POST Logout

Encerra a sessão do usuário autenticado.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário). Veja Autenticação.

O accessToken atual também deixa de valer

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.

O cookie do navegador é do front

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
}