Documentos da API de validação de e-mail

Começar a trabalhar

Todos os pedidos de API requerem autenticação utilizando uma chave de API. Pode encontrar a sua chave de API no painel de controlo.

Cabeçalho: "x-api-key: your-api-key"

Verificação única

Verificar a validade, o estado descartável, os serviços de privacidade e a capacidade de entrega de um único endereço de correio eletrónico ou domínio.

Ponto final

GET /v1/verify

Parâmetros

Nome	Tipo	Necessário	Descrição
input	string	Sim	Endereço de correio eletrónico ou domínio a verificar (por exemplo, test@example.com ou example.com)

Campos de resposta

Campo	Descrição
valid	Indica se o formato do correio eletrónico está correto
block	Indica se o correio eletrónico deve ser bloqueado (verdadeiro se descartável, privacidade, applePrivateEmail, entregável ou catch_all for verdadeiro)
disposable	Determina se o endereço de correio eletrónico é temporário ou descartável
privacy	Determina se o servidor de correio eletrónico está a utilizar um alias ou reencaminhador de correio eletrónico
applePrivateEmail	Indica se o correio eletrónico é um endereço de correio eletrónico Apple Private
deliverable	Verifica se a caixa de correio existe e se pode receber mensagens de correio eletrónico
domain	A parte do domínio do endereço de correio eletrónico
email_address	O endereço de correio eletrónico
catch_all	Indica se o domínio tem uma configuração de correio eletrónico abrangente que aceita todas as mensagens de correio eletrónico recebidas, independentemente do endereço do destinatário
mx_found	Indica se o domínio tem servidores de correio válidos (registos MX)
remaining_credits	O número de créditos API restantes na sua conta

Lista negra / Lista branca: Apenas o campo de bloqueio reflecte a pertença à lista. Lista negra → bloquear: verdadeiro; lista branca → bloquear: falso; não está na lista branca (quando activada) → bloquear: verdadeiro. Não utilizar valid para decidir se se deve bloquear com base em listas.

Exemplo de resposta

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Exemplos de códigos

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Experimentar

Chave API

É necessária uma chave de API para testar os pontos de extremidade.

Endereço de correio ou domínio

Experimentar com:

Verificação de lotes

Verificar vários endereços de correio eletrónico ou domínios num único pedido (máximo de 100 itens).

Ponto final

POST /v1/verify/batch

Parâmetros

Nome	Tipo	Necessário	Descrição
inputs	array of strings	Sim	Conjunto de endereços de correio eletrónico ou domínios a verificar

Exemplos de códigos

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

Experimentar

Chave API

É necessária uma chave de API para testar os pontos de extremidade.

Endereços de correio ou domínios

Experimente com domínios diferentes:

Verificação de entrega única

Verificação rápida da capacidade de entrega de correio eletrónico utilizando a verificação MX e SMTP sem chamadas de API externas. Devolve apenas campos relacionados com a capacidade de entrega para tempos de resposta mais rápidos.

Ponto final

GET /v1/verify/deliverable

Parâmetros

Nome	Tipo	Necessário	Descrição
input	string	Sim	Endereço de correio eletrónico para verificar a capacidade de entrega (por exemplo, test@example.com). A entrada apenas de domínio não é suportada para este ponto final.

Campos de resposta

Campo	Descrição
valid	Indica se o formato do correio eletrónico está correto
deliverable	Verifica se a caixa de correio existe e se pode receber mensagens de correio eletrónico
mx_found	Indica se o domínio tem servidores de correio válidos (registos MX)
catch_all	Indica se o domínio tem uma configuração de correio eletrónico abrangente que aceita todas as mensagens de correio eletrónico recebidas, independentemente do endereço do destinatário
email_address	O endereço de correio eletrónico
remaining_credits	O número de créditos API restantes na sua conta

Exemplo de resposta

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "test@example.com",
  "remaining_credits": 99
}

Exemplos de códigos

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Experimentar

Chave API

É necessária uma chave de API para testar os pontos de extremidade.

Endereço de correio ou domínio

Experimentar com:

Lista branca e lista negra

Controle que e-mails e domínios são bloqueados com regras de lista negra e branca por utilizador. Estas listas definem o campo block em cada resposta de verificação.

{}

O campo block

Cada resposta de verificação inclui um campo block. Use este campo para decidir se deve bloquear o e-mail/domínio com base nas suas listas:

trueO e-mail ou o seu domínio está na lista negra → block: true. Adicionar um domínio bloqueia todos os e-mails nesse domínio.

trueA lista branca está ativa mas o e-mail/domínio não está nela → block: true.

falseA lista branca está ativa e o e-mail ou o seu domínio está nela → block: false.

—Nenhuma lista se aplica → block segue o resultado normal da verificação.

Visão geral

✘

Lista negra

Bloquear sempre e-mails ou domínios específicos. Por exemplo, adicionar example.com à lista negra faz com que qualquer e-mail @example.com devolva block: true, independentemente do resultado da verificação.

✔

Lista branca

Permitir apenas e-mails ou domínios específicos. Com a lista branca ativa, só as entradas da lista têm block: false; todo o resto tem block: true. Por exemplo, adicionar gmail.com permite qualquer @gmail.com, mas user@yahoo.com seria bloqueado. Desativada, a lista branca não tem efeito.

Pode adicionar um e-mail completo (user@example.com) ou um domínio (example.com). Adicionar um domínio aplica-se a todos os e-mails nesse domínio. Não se distingue maiúsculas de minúsculas.

Como funciona

Ordem de avaliação

Primeiro a lista negra — Se o e-mail ou o seu domínio está na lista negra, o resultado é block: true. Não se aplica mais lógica de listas.

Lista branca (se ativa) — Se o e-mail/domínio está na lista branca → block: false. Caso contrário → block: true.

Lista branca desativada — Aplicam-se apenas a lista negra e a verificação normal.

A lista negra tem sempre prioridade: um endereço na lista negra permanece bloqueado mesmo que esteja também na branca.

O que é verificado

Verificação de e-mail — a API verifica o endereço completo e o domínio contra ambas as listas. Qualquer correspondência aplica a regra da lista.

Verificação de domínio — apenas o domínio é verificado contra a lista negra e (se ativa) a branca.

Referência rápida

Lista branca ativa	Na lista negra	Na lista branca	valor de block
Não	Sim	—	`true`
Não	Não	—	Normal
Sim	Sim	Qualquer	`true`
Sim	Não	Sim	`false`
Sim	Não	Não	`true`

Endpoints de listas da API

Todos os endpoints de listas requerem o cabeçalho: X-API-Key: your-api-key

Lista negra

GET/v1/blacklist

Listar entradas da lista negra

POST/v1/blacklist

Adicionar e-mail ou domínio · { "value": "..." }

DELETE/v1/blacklist

Remover entrada · value=...

Lista branca

GET/v1/whitelist

Listar entradas da lista branca

POST/v1/whitelist

Adicionar e-mail ou domínio · { "value": "..." }

DELETE/v1/whitelist

Remover entrada · value=...

GET/v1/whitelist/enabled

Obter estado da lista branca · { "enabled": boolean }

PUT/v1/whitelist/enabled

Ativar/desativar lista branca · { "enabled": true | false }

Formato do valor

user@example.com — E-mail: formato válido, ex. user@example.com
example.com — Domínio: formato válido, ex. example.com

Valores inválidos são rejeitados com 400. As entradas são armazenadas normalizadas. Duplicados são fundidos numa única entrada.

Onde as listas são aplicadas

As regras das listas são aplicadas após a verificação. As respostas de verificação de e-mail (única e em lote) e de domínio já incluem a lista negra e branca do utilizador no campo block.

Servidor MCP (integração de agentes de IA)

Integre a verificação de correio eletrónico diretamente em agentes de IA como o Cursor e o Claude Desktop utilizando o Protocolo de Contexto de Modelo (MCP). O seu assistente de IA pode verificar e-mails, verificar domínios e validar a sintaxe sem sair do editor.

Configuração

Adicione a seguinte configuração ao seu ficheiro de configuração .cursor/mcp.json ou Claude Desktop:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Ferramentas disponíveis

Ferramenta	Descrição	Entrada	Créditos
verify_email	Verificação completa do correio eletrónico, incluindo verificações de sintaxe, MX, SMTP, descartável, privacidade e capacidade de entrega	{ email: string }	1
verify_domain	Verificação completa do domínio, incluindo registos MX, descartáveis, privacidade e deteção de "catch-all	{ domain: string }	1
check_deliverability	Verificação rápida apenas da capacidade de entrega utilizando a verificação MX e SMTP sem chamadas externas à API	{ email: string }	1
verify_batch	Verificação em lote de até 100 e-mails ou domínios num único pedido	{ inputs: string[] }	1 per item
validate_email_syntax	Validação rápida da sintaxe local em relação ao RFC 5322 sem chamadas de rede	{ email: string }	0 (free)