Verificação de Código OTP
Descrição
Verifica se o código OTP informado para o e-mail é válido e ainda está dentro do prazo de expiração.
Verbo
POST
Endpoint
/auth/verify-otp
Cabeçalhos
Parâmetro | Valor |
---|---|
Content-Type | application/json |
Campos Esperados
Campo | Tipo | Obrigatório | Descrição |
---|---|---|---|
string | Sim | E-mail do usuário. | |
otp | string | Sim | Código de verificação enviado por e-mail. |
Corpo da Requisição
{
"email": "user@email.com",
"otp": "123456"
}
Observação: o corpo da requisição deve ser enviado como JSON no formato raw.
Respostas
Sucesso - 200
{
"success": true,
"code": 200,
"message": "OTP code is valid.",
"email": "user@email.com"
}
Erro - 400 (Campos obrigatórios)
{
"status": 400,
"error": 400,
"messages": {
"error": "The email and OTP code fields are required."
}
}
Erro - 404 (Código inválido ou expirado)
{
"status": 404,
"error": 404,
"messages": {
"error": "Invalid or expired OTP code."
}
}
Códigos de Resposta
- 200 - Código verificado com sucesso
- 400 - Dados obrigatórios ausentes
- 404 - OTP inválido ou expirado