Plantonizei

Conta e acesso › Autenticação

Pedir link de nova senha

POST/api/v1/auth/forgot-passwordPública, sem sessão

Como funciona

Começa a recuperação de senha: se o e-mail tiver conta, chega nele um link para criar uma senha nova. O link leva o token que POST /auth/reset-password consome.

A resposta é sempre a mesma, com conta ou sem, com e-mail válido ou não. Assim a rota não serve para descobrir quem é cliente. Por isso a tela deve mostrar a mensagem que vier e nunca dizer "e-mail não encontrado".

  • É pública e tem teto de tentativas por endereço de origem, para ninguém usar a rota para lotar a caixa de e-mail de outra pessoa.

Parâmetros

  • emailCorpo · stringE-mail.

Respostas

200 · Mensagem genérica: se houver conta, o link foi enviado.

  • messagestring · Mensagem para mostrar à pessoa.

Corpo de exemplo

{
  "message": "texto"
}