Guia de Início Rápido

1

Passo 1 — Obtenha sua Chave de API

Crie uma conta gratuita no Easy Email Verification. Sua chave de API estará disponível instantaneamente no seu painel.

2

Passo 2 — Faça sua primeira requisição

Envie uma requisição GET com sua chave de API e o endereço de e-mail a verificar.

curl "https://api.easyemailverification.com/v1/verify \
  ?apikey=YOUR_API_KEY \
  &email=user%40example.com"

<?php
$result = json_decode(file_get_contents(
    "https://api.easyemailverification.com/v1/verify"
    . "?apikey=YOUR_API_KEY&email=" . urlencode('user@example.com')
), true);
var_dump($result);

import requests, pprint

r = requests.get(
    "https://api.easyemailverification.com/v1/verify",
    params={"apikey": "YOUR_API_KEY", "email": "user@example.com"}
)
pprint.pprint(r.json())

const r = await fetch(
  "https://api.easyemailverification.com/v1/verify?apikey=YOUR_API_KEY&email=user@example.com"
);
console.log(await r.json());

3

Passo 3 — Leia a resposta

A API retorna um objeto JSON com todos os detalhes da verificação. Use safe_to_send como seu sinal primário.

200 OK

{
  "email":        "user@example.com",
  "result":       "valid",
  "safe_to_send": true,
  "disposable":   false,
  "accept_all":   false,
  "role":         false,
  "free":         false,
  "mx_record":    "mail.example.com",
  "did_you_mean": null
}

4

Passo 4 — Integre ao seu fluxo

Chame a API em formulários de cadastro, antes de importações no ESP, ou como um job em lote usando o endpoint bulk.

Signup form integration example (PHP)

<?php
// On POST /register
$email  = $_POST['email'] ?? '';
$apikey = 'YOUR_API_KEY';
$url    = "https://api.easyemailverification.com/v1/verify?apikey={$apikey}&email=" . urlencode($email);
$check  = json_decode(file_get_contents($url), true);

if (!$check['safe_to_send']) {
    // Reject registration
    http_response_code(422);
    echo json_encode(['error' => 'Invalid email address.']);
    exit;
}
// Proceed with registration...