Nunciatura Provista

API Documentation V1

Reenviar Email de Credenciais

Reenvia o email com senha temporária e link de login para um informador

Este endpoint é do tipo: Protected

Descrição

Reenvia o email com credenciais de acesso para um informador específico:

  • Gera uma nova senha temporária e substitui a senha anterior
  • Define must_change_password = true
  • Envia email com senha temporária e link de login (sem OTP)
  • Rate limit: 1 envio a cada 5 minutos por email
  • Requer autenticação JWT válida

Detalhes do Endpoint

VERBO

POST

URL BASE

http://api.provisao.nabrasil.org.br/v1

ENDPOINT

/informers/{id}/resend-verification-email

Parâmetros da URL

Parâmetro Tipo Descrição
id string (UUID) UUID do usuário (users.id) ou UUID do informador (informers.id) 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/informers/9fd6b694-602a-461f-a052-c473f59bbcc6/resend-verification-email
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

Respostas

Sucesso - 200

{
  "success": true,
  "message": "Email com credenciais de acesso reenviado com sucesso",
  "requires_password_change": true
}

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 informador.

Erro - 400 (Email já verificado)

{
  "success": false,
  "message": "O email deste usuário já está verificado"
}

Condição: O informador já possui email verificado. Não é possível reenviar para um email já verificado.

Erro - 404 (Informador 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 Informador não encontrado
500 Erro ao enviar email