Pular para o conteúdo principal
A API de Verificação de e-mail oferece um fluxo em duas etapas: enviar um código de uso único para um endereço de e-mail e, em seguida, verificar o código que o usuário digita. O sistema também faz uma avaliação de risco que inclui exposição a vazamentos de dados, detecção de provedores descartáveis e verificações de entregabilidade.

Endpoints

Enviar código por e-mail

POST /v3/email/send/: envia um código de verificação de uso único para um endereço de e-mail.

Verificar código de e-mail

POST /v3/email/check/: verifica o código e retorna os dados de risco do e-mail.

Pontuar risco do e-mail

POST /v3/email/risk/: pontua o risco de entregabilidade, de vazamento de dados e de e-mail descartável sem enviar um código.

Como funciona

  1. Chame Send Email Code com o endereço de e-mail de destino
  2. O usuário recebe um código de 6 dígitos (válido por 5 minutos)
  3. Chame Check Email Code com o e-mail e o código
  4. Receba o resultado da verificação junto com os sinais de risco (exposição a vazamentos de dados, provedor descartável, entregabilidade)
Por padrão, os e-mails de OTP avulsos usam a identidade visual da Didit. Para usar o remetente e a identidade visual de marca própria configurados na sua aplicação em uma sessão específica de verificação de e-mail avulsa, envie options.use_white_label_customization: true para POST /v3/email/send/. O padrão é false.

Sinais de risco

A resposta da verificação inclui: Para a estrutura completa da resposta, consulte o Relatório de verificação de e-mail.
Última modificação em 1 de novembro de 2026