Redefinição de Senha

Descrição

Permite redefinir a senha de um usuário previamente autenticado por código OTP. A nova senha será definida após a validação do e-mail e OTP.

Verbo

POST

Endpoint

/auth/reset-password

Cabeçalhos

Parâmetro Valor
Content-Type application/json

Campos Esperados

Campo Tipo Obrigatório Descrição
email string Sim E-mail do usuário que solicitou a redefinição.
otp string Sim Código OTP de verificação.
password string Sim Nova senha. Mínimo 8 caracteres.
confirm_password string Sim Confirmação da nova senha. Deve ser igual.

Corpo da Requisição

{
  "email": "user@email.com",
  "otp": "123456",
  "password": "novasenha1234",
  "confirm_password": "novasenha1234"
}

Observação: o corpo da requisição deve ser enviado como JSON no formato raw.

Respostas

Sucesso - 200

{
  "success": true,
  "code": 200,
  "message": "Password successfully updated."
}

Erro - 400 (Campos obrigatórios)

{
  "status": 400,
  "error": 400,
  "messages": {
    "error": "All fields are required."
  }
}

Erro - 404 (OTP inválido)

{
  "status": 404,
  "error": 404,
  "messages": {
    "error": "Invalid or expired OTP code."
  }
}

Erro - 500 (Falha ao atualizar)

{
  "status": 500,
  "error": "An error occurred while processing the request."
}

Códigos de Resposta

  • 200 - Senha redefinida com sucesso
  • 400 - Campos inválidos ou ausentes
  • 404 - OTP inválido ou expirado
  • 500 - Erro interno do servidor