Entrar
Abre uma sessão nova. O access token vale 15 minutos; o refresh token renova a sessão. Após 5 senhas erradas a conta fica bloqueada por 10 minutos (403).
POST
/identity/v1/auth/loginCorpo da requisição
emailstringobrigatórioE-mail da conta.
máx. 256passwordstringobrigatórioSenha da conta.
máx. 128
Respostas
200OK
{
"accessToken": "eyJhbGciOiJSUzI1NiIs…",
"refreshToken": "rt_9qX2…",
"expiresIn": 900,
"tokenType": "Bearer"
}4 campos descrição de cada um
accessTokenstringJWT (RS256) para o header Authorization: Bearer. Vale 15 minutos.
refreshTokenstringToken opaco de uso único para renovar a sessão (POST /v1/auth/refresh).
expiresInintegerSegundos até o access token expirar.
tokenTypestringSempre "Bearer".
padrão "Bearer"
400Bad Request
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "auth.invalid / validation",
"status": 400,
"detail": "Mensagem legível para pessoas.",
"code": "auth.invalid / validation",
"traceId": "00-4bf9…-01"
}401Unauthorized
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "auth.invalid_credentials",
"status": 401,
"detail": "Mensagem legível para pessoas.",
"code": "auth.invalid_credentials",
"traceId": "00-4bf9…-01"
}403Forbidden
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "auth.locked_out",
"status": 403,
"detail": "Mensagem legível para pessoas.",
"code": "auth.locked_out",
"traceId": "00-4bf9…-01"
}