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
email 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