Sessão e logout

Enviar a credencial nas rotas protegidas

As rotas protegidas aceitam o token no header Authorization ou o cookie de sessão emitido no login.

export ACCESS_TOKEN='<access_token recebido>'

curl -i \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  "$API_BASE/download/list"

# cookies.txt foi gravado no login com curl -c cookies.txt
curl -i -b cookies.txt "$API_BASE/download/list"

Se o header Authorization e o cookie __Host-dirl_session forem enviados juntos, o header prevalece.

Expiração

A sessão deixa de ser aceita quando o token expira, conforme a política configurada no ambiente. Para tokens OAuth, a validade em segundos é informada em expires_in.

Quando uma rota protegida responder 401, obtenha uma nova credencial (novo login ou novo token) e repita a chamada.

Encerrar a sessão

Use GET ou POST /auth/logout, enviando a mesma credencial usada nas rotas protegidas. Quando aplicável, a API limpa o cookie de sessão.

curl -i -X POST \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  "$API_BASE/auth/logout"

curl -i -X POST -b cookies.txt -c cookies.txt \
  "$API_BASE/auth/logout"

Para sessões abertas por SSO, use o logout federado.