Reenviar Email de Verificação
Reenvia o email de verificação para um usuário específico
Descrição
Reenvia o email de verificação para um usuário específico com as seguintes funcionalidades:
- Gera novo código OTP de 6 dígitos com expiração de 30 minutos
- Invalida código anterior do usuário
- Envia email de verificação via SendGrid
- Valida se o email já está verificado
- Registra logs de auditoria com IP e User-Agent
- Requer autenticação JWT válida
Importante: Este endpoint só funciona para usuários que ainda não verificaram o email. Se o email já estiver verificado, retorna erro 400.
Detalhes do Endpoint
VERBO
POST
URL BASE
http://api.provista.hmg.nabrasil.org.br/v1
ENDPOINT
/users/{id}/resend-verification-email
Parâmetros da URL
| Parâmetro | Tipo | Descrição |
|---|---|---|
| id | string (UUID) | UUID do usuário para reenviar email de verificação |
Cabeçalhos
| Parâmetro | Valor |
|---|---|
| Authorization | Bearer {token} |
| Content-Type | application/json |
| Accept | application/json |
Exemplo de Requisição
POST /v1/users/b033e2ff-4114-5bgg-9797-e8bfc6c162d0/resend-verification-email
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...Respostas
Sucesso - 200
{
"success": true,
"message": "Email de verificação reenviado com sucesso"
}Condição: Email de verificação enviado com sucesso. Um novo código OTP de 6 dígitos foi gerado e enviado para o email do usuário.
Erro - 400 (Email já verificado)
{
"success": false,
"message": "O email deste usuário já está verificado"
}Condição: O usuário já possui email verificado. Não é possível reenviar para um email já verificado.
Erro - 404 (Usuário não encontrado)
{
"success": false,
"message": "Usuário não encontrado"
}Erro - 401 (Token inválido)
{
"success": false,
"message": "Token inválido"
}Erro - 500 (Erro ao enviar email)
{
"success": false,
"message": "Erro ao enviar email de verificação. Verifique as configurações de email."
}Condição: Falha no envio do email. Verifique as configurações do SendGrid ou servidor de email.
Funcionalidades
- Geração de Código OTP: Cria novo código de 6 dígitos com expiração de 30 minutos
- Invalidação de Código Anterior: Remove códigos anteriores do mesmo email
- Envio via SendGrid: Utiliza as configurações do SendGrid configuradas no sistema
- Validação de Status: Verifica se o email já está verificado antes de enviar
- Auditoria Completa: Registra todos os eventos em logs com IP e User-Agent
- Tratamento de Erros: Retorna mensagens descritivas em caso de falha
Códigos de Resposta
| Código | Descrição |
|---|---|
| 200 | Email reenviado com sucesso |
| 400 | Email já verificado |
| 401 | Token inválido ou não fornecido |
| 404 | Usuário não encontrado |
| 500 | Erro ao enviar email |