Integração com a API MailChecker

Envie o endereço e sua chave de API em uma requisição HTTP. A resposta JSON informa o resultado de cada verificação e o motivo da recomendação.

Abrir documentação interativa

Requisição

HTTP / cURL
curl --get 'https://mailchecker.jrmania.com.br/v1/email/validate' \
  --data-urlencode '[email protected]' \
  --header 'X-API-Key: YOUR_API_KEY'

Resposta ilustrativa

JSON
{
  "decision": "allow",
  "risk_score": 10,
  "reason_code": "VALID",
  "syntax": { "valid": true },
  "dns_mx": { "mx_found": true },
  "disposable": { "is_disposable": false },
  "smtp": { "status": "pass" }
}

Validar não garante a entrega da mensagem.

Autentique a chamada

Envie sua chave no header X-API-Key. Use-a no servidor e mantenha o segredo fora do código público.

Informe o e-mail

Passe o endereço no parâmetro email de GET /v1/email/validate.

Trate a resposta

Use decision, reason_code e os sinais de validação para aplicar a política da sua aplicação.

Como interpretar o resultado

Consulte sintaxe, DNS/MX, identificação de domínio descartável, situação SMTP, uso de cache e motivo da decisão. Os nomes dos campos são os mesmos em qualquer idioma.

allow

Seguir

A validação encontrou sinais favoráveis.

warning

Revisar

Há uma limitação ou condição que merece atenção.

block

Bloquear

A validação encontrou um motivo para bloquear.

Tratamento de erros

401
Chave ausente ou inválida. Revise a autenticação.
403
Credencial administrativa não pode ser usada na validação pública.
429
Limite de requisições excedido. Respeite a orientação de nova tentativa.

Campos disponíveis na resposta

Veja o contrato completo e teste os endpoints. Validar um endereço exige uma chave válida.

Abrir documentação interativa