Verificar um endereço
curl --request POST \ "https://api.iporto.com.br/api/external/v1/email-validations" \ --header "Authorization: Bearer $IPORTO_API_KEY" \ --header "Content-Type: application/json" \const resposta = await fetch("https://api.iporto.com.br/api/external/v1/email-validations", { method: "POST", headers: { Authorization: `Bearer ${process.env.IPORTO_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ }),});
console.log(await resposta.json());$client = new \GuzzleHttp\Client();
$resposta = $client->post('https://api.iporto.com.br/api/external/v1/email-validations', [ 'headers' => ['Authorization' => 'Bearer '.getenv('IPORTO_API_KEY')],]);
print_r(json_decode((string) $resposta->getBody(), true));import osimport requests
url = 'https://api.iporto.com.br/api/external/v1/email-validations'headers = {'Authorization': 'Bearer ' + os.environ['IPORTO_API_KEY']}
print(resposta.json())Verifica um endereço na hora e devolve o resultado na resposta.
⚠️ Tem teto de requisições por minuto, por conta: a verificação abre conexão com o servidor de destino, e um laço sem limite vira uma enxurrada de conexões saindo do nosso IP — que é como um IP entra em lista negra.
Para muitos endereços de uma vez, use os lotes: eles custam uma requisição só.
Authorizations
Seção intitulada “Authorizations”Request Bodyrequired
Seção intitulada “Request Bodyrequired”object
Examplegenerated
{ "email": "example"}Responses
Seção intitulada “Responses”O resultado da verificação.
O mesmo objeto que a tela do Validador consome. ⚠️ Os sinalizadores de result são TRI-ESTADO: true, false ou null — e null significa que o motor não soube, nunca “não”.
object
object
object
object
object
object
Examplegenerated
{ "object": "example", "id": "example", "batch_id": "example", "email": "example", "status": "example", "send": { "status": "example", "label": "example", "reasons": [ "example" ] }, "result": { "valid": true, "disposable": true, "gibberish": true, "typing_error": true, "trap": true, "abandoned": true, "free": true, "role": true, "name": true, "bank": true, "gov": true, "catch_all": true }, "domain": { "name": "example", "mx": "example" }, "diagnostic": { "smtp_response": "example" }, "line": { "number": 1, "content": "example" }, "credits_charged": 1, "checked_at": "example", "created_at": "example", "expires_at": "example"}A chave não foi enviada, ou venceu.
object
Examplegenerated
{ "error": "example"}Sem crédito. O pedido está correto — o que falta é saldo, e por isso não é 422.
object
Examplegenerated
{ "error": "example"}O corpo não traz email, ou ele não é texto.
object
Examplegenerated
{ "error": "example"}Acima do teto de verificações por minuto desta conta.
object
Examplegenerated
{ "error": "example"}Não foi possível consultar o saldo. Não quer dizer que falta crédito: quer dizer que não conseguimos perguntar. Tente de novo.
object
Examplegenerated
{ "error": "example"}