Skip to main content
POST
/
auth
/
reset-password
Redefinir Senha
curl --request POST \
  --url https://api.example.com/auth/reset-password \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "otpId": "<string>",
  "code": "<string>",
  "password": "<string>"
}
'
// No content — password reset successfully
Redefine a senha do usuario apos validacao de OTP. O usuario deve ter previamente solicitado e validado um OTP com o contexto RESET_PASSWORD.
curl -X POST https://api.awsales.io/studio/auth/reset-password \
  -H "Content-Type: application/json" \
  -d '{
    "otpId": "019525fe-8f80-7afa-f2be-0c2d4e6a8b0e",
    "code": "123456",
    "password": "NewSecureP@ss456"
  }'

Fluxo de Redefinicao de Senha

1

Solicite um OTP de redefinicao

Chame Enviar OTP com context: "RESET_PASSWORD" e o email do usuario. A API retorna um otpId.
2

Valide o OTP

Chame Validar OTP com o otpId, email, codigo e contexto.
3

Defina a nova senha

Chame este endpoint com o otpId, code e a nova password. Em caso de sucesso, a API retorna 204 No Content.
4

Faca sign-in com a nova senha

O usuario agora pode fazer Sign In com suas novas credenciais.

Corpo da Requisicao

otpId
string
required
O identificador da solicitacao OTP.
code
string
required
O codigo OTP validado.
password
string
required
A nova senha.

Resposta

// No content — password reset successfully

Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
400auth.invalid_tokenToken de redefinicao invalido ou expirado
400auth.password_too_weakA senha nao atende aos requisitos de seguranca
500internal_server_errorOcorreu um erro inesperado