Redefinição de Senha

PUT /passwordReset

HTTP

PUT /passwordReset HTTP/1.1
Host: {{URL}}
Content-Type: application/json
Accept: application/json

Endpoint para redefinir a senha do usuário utilizando o token de recuperação enviado por email. Este endpoint permite que o usuário defina uma nova senha após solicitar a recuperação.

Atributos para redefinição de senha

Campo	Tipo	Descrição	Obrigatório
token	string	Token de recuperação recebido no email de redefinição de senha.	✓
password	string	Nova senha do usuário. Deve conter pelo menos 8 caracteres. Um caracter especial, uma letra maiúscula e um número são obrigatórios.	✓

Requisição

Body

{
    "token": "bdaf9a55e40b9f3ee145a1c05a6c7f947f63fae923026688a983814c6158bf39",
    "password": "SenhaForte!15152"
}

Resposta

200

{
    "success": true,
    "message": "Senha redefinida com sucesso."
}

Resposta de Sucesso

Campo	Tipo	Descrição	Obrigatório
success	boolean	Indica se a operação foi bem-sucedida, sempre true em caso de sucesso.	✓
message	string	Mensagem de confirmação da redefinição de senha.	✓

Errors

Código	Referência	Explicação
400	BAD REQUEST	O servidor não processará a solicitação devido a algo que é percebido como sendo um erro do cliente. Campos obrigatórios ausentes ou inválidos.
401	UNAUTHORIZED	Token inválido, expirado ou já utilizado.
404	NOT FOUND	Token não encontrado no sistema.
422	UNPROCESSABLE ENTITY	O servidor não conseguiu processar as informações contidas na requisição. Senha não atende aos critérios mínimos.
500	INTERNAL SERVER ERROR	Erro interno do servidor.

Importante

Sobre o Token

• O token de recuperação é válido por 24 horas após o envio do email
• Cada token pode ser usado apenas uma vez
• Após o uso bem-sucedido, o token é invalidado automaticamente
• Todos os outros tokens de recuperação do usuário são revogados após a redefinição

Critérios da Nova Senha

• Deve conter pelo menos 6 caracteres
• Recomenda-se usar uma combinação de letras, números e símbolos
• A nova senha é criptografada antes de ser armazenada no sistema

Fluxo Completo

1. Usuário solicita recuperação de senha através do endpoint /sendRecovery
2. Sistema envia email com token de recuperação
3. Usuário acessa o link do email contendo o token
4. Usuário utiliza este endpoint para definir nova senha
5. Sistema confirma a alteração e invalida todos os tokens do usuário