API de verificação de endereços de email
Verifique listas de email programaticamente — menos bounces, melhor entregabilidade
Ligue formulários de registo, CRMs e landing pages ao EmailVerifier. Verifique endereços via REST API em tempo real ou jobs bulk — faturação transparente 1 request = 1 credit.
- Verificação em tempo real
- Bulk até 50.000 emails
- 1 pedido = 1 crédito
Exemplo de pedido
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_…" \
-d '{"email":"user@company.com"}'Base de conhecimento API
Escolha um tópico — de autenticação e créditos a jobs bulk, webhooks e códigos de erro.
POST /verify — um endereço, resultado em subsegundos, estado valid/invalid/risky.
Saber maisAPIVerificação bulk de emailVerificação em massa de listas CSV — fila de jobs, polling de progresso e exportação CSV.
Saber maisAPICréditos e faturaçãoSaldo, uso da API, 1 credit = 1 verificação, tratamento HTTP 402.
Saber maisAPIChaves API e autenticaçãoBearer ev_live_, painel de tokens, boas práticas de armazenamento seguro.
Saber maisAPIWebhooks e integraçõesverification.completed, assinatura HMAC, CRM e automação de marketing.
Saber maisAPIReferência OpenAPIEspecificação YAML completa, UI Redoc e catálogo de erros HTTP.
Saber maisO que é uma API de verificação de email?
Uma interface REST para validar endereços antes de enviar campanhas.
Uma API de verificação de email verifica se um endereço existe, se o domínio aceita correio e se a caixa é disposable ou catch-all. Reduz a taxa de bounce, protege a reputação do remetente e melhora a entrega na caixa de entrada.
A API é servida via HTTPS em /api/v1. Autentique com chave Bearer (ev_live_…) ou sessão do painel. Cada POST /verify bem-sucedido custa um credit — sem subscrição nem taxas ocultas em GET.
Quando usar uma API validadora de email
Cenários de integração comuns em produtos B2B e stacks de marketing.
Formulários de registo
Valide email em tempo real no registo — rejeite invalid e disposable antes de inserir na lista.
CRM e captura de leads
Limpe leads de landing pages e webhooks — só endereços entregáveis entram no pipeline.
Higiene de listas antes de campanhas
Bulk API antes de newsletters — menos bounces, maior open rate e menor custo ESP.
Plataformas SaaS
Integre verificações de email no produto — faturação por créditos simplifica o pricing para clientes.
Modelo de créditos API
Preços simples: um pedido de verificação = um credit.
- POST /verify cobra 1 credit por pedido bem-sucedido (HTTP 200) com chaves ev_live_, mesmo que o mesmo endereço tenha sido verificado antes via API. Chaves sandbox (ev_test_) devolvem mock sem debitar créditos.
- Operações GET — saldo, histórico, estado de bulk job, exportação CSV — são gratuitas.
- Saldo insuficiente devolve HTTP 402 (insufficient_credits). Erros do motor (503) não cobram credit.
Autenticação e chaves API
Acesso seguro via header Authorization.
- Inicie sessão no painel e abra API tokens (/account/api).
- Crie chave de produção (ev_live_) ou sandbox (ev_test_) no painel — o secret completo é mostrado apenas uma vez.
- Envie a chave como Authorization: Bearer ev_live_… — nunca em URLs ou código cliente.
Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/jsonInício rápido — API de verificação de email
Duas chamadas: verificação de saldo e primeira verificação.
1. Verificar saldo de créditos
curl https://propercheck.pl/api/v1/credits \
-H "Authorization: Bearer ev_live_YOUR_KEY"2. Verificar um endereço de email
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"john@company.com"}'Verificação única (tempo real)
POST /api/v1/verify aceita JSON com campo email. A resposta inclui status, score 0–100, provider (Google, Microsoft, hosts regionais) e enrichment (MX, catch-all).
POST /api/v1/verify
Estrutura de resposta JSON
Campos devolvidos após verificação bem-sucedida.
{
"verificationId": "ver_abc123",
"email": "john@company.com",
"status": "valid",
"score": 92,
"provider": "google",
"enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
"creditsRemaining": 149
}Estados de verificação de email
Classificação usada na API, painel e exportações CSV.
valid
valid — o endereço existe e pode receber correio; seguro para envio.
invalid
invalid — o endereço não existe ou o domínio não tem correio; remover da lista.
risky
risky — baixa confiança (ex. disposable, role account); cautela em campanhas.
catch_all
catch_all — o servidor aceita todos os endereços do domínio; maior risco de bounce.
unknown
unknown — resposta SMTP inconclusiva; considere reverificação posterior.
Referência de endpoints REST
Lista completa de caminhos API v1 com custo em créditos.
| Método | Caminho | Créditos | Descrição |
|---|---|---|---|
| POST | /verify | 1 | Verificação de email única em tempo real |
| GET | /verify/:id | 0 | Obter resultado por verificationId |
| GET | /verifications | 0 | Histórico de verificações e estatísticas de 30 dias |
| GET | /credits | 0 | Saldo atual de créditos da conta |
| POST | /bulk | N | Criar job bulk (N créditos) |
| GET | /bulk/:id | 0 | Estado e progresso do job bulk |
| GET | /bulk/:id/export | 0 | Descarregar resultados como CSV |
| GET/POST/PATCH/DELETE | /api-keys | 0 | Gestão de tokens API (sessão) |
| GET/POST/DELETE | /webhooks | 0 | Configuração de webhooks (sessão) |
| GET | /usage | 0 | Estatísticas de uso da API e créditos |
API de verificação de email em massa
Verifique milhares de endereços num job — ideal antes de campanhas grandes.
- POST /bulk com array emails ou texto CSV — créditos reservados para N endereços únicos.
- GET /bulk/:id — polling de estado (queued → processing → completed).
- GET /bulk/:id/export — CSV com colunas email, status, score, provider.
curl -X POST https://propercheck.pl/api/v1/bulk \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"emails":["a@b.co","c@d.co"]}'Webhooks — evento verification.completed
Receba POST no seu URL quando a verificação terminar. Header X-EV-Signature contém HMAC-SHA256 do body — verifique antes de processar.
X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>Limites de taxa
60 pedidos por minuto por chave API por defeito. Exceder devolve HTTP 429 com rate_limit_exceeded. Limites por chave — tokens separados por integração.
Header opcional em POST /verify — retries seguros sem débito duplo de credit (TTL 24h).
X-Request-Id
Cada resposta API inclui X-Request-Id — inclua ao contactar suporte para depuração da integração.
Códigos de erro HTTP
| HTTP | Código | Descrição |
|---|---|---|
| 401 | unauthorized | Sessão ou chave API em falta no pedido. |
| 401 | invalid_api_key | Chave API inválida, expirada ou revogada. |
| 400 | invalid_request | JSON inválido, campo email em falta ou endereço mal formado. |
| 402 | insufficient_credits | Créditos insuficientes — carregue em /account/credits. |
| 429 | rate_limit_exceeded | Limite de taxa excedido — 60 pedidos/min por chave API por defeito. |
| 503 | engine_unavailable | Motor de verificação indisponível — credit não cobrado. |
Exemplos de integração
O mesmo fluxo de verificação em linguagens populares.
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"john@company.com"}'FAQ — API de verificação de email
Perguntas frequentes de developers e marketers.
OpenAPI 3.1 e Redoc
Especificação machine-readable para codegen, testes de contrato e pipelines CI.
Comece a verificar emails via API
Créditos de teste grátis no registo. Chave API no painel em um minuto.
Gere a sua chave no painel de conta.