Recuperar conta com código
Define uma senha nova usando um código de recuperação (uso único). Encerra todas as sessões e já entra.
POST
/identity/v1/auth/recoverCorpo da requisição
emailstringobrigatórioE-mail da conta.
máx. 256codestringobrigatórioUm dos códigos de recuperação.
máx. 32newPasswordstringobrigatórioSenha nova.
mín. 8má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": "Unauthorized",
"status": 401,
"detail": "Mensagem legível para pessoas.",
"code": "Unauthorized",
"traceId": "00-4bf9…-01"
}423Locked
{
"type": "https://tools.ietf.org/html/rfc9110",
"title": "error",
"status": 423,
"detail": "Mensagem legível para pessoas.",
"code": "error",
"traceId": "00-4bf9…-01"
}