API de validação de email

GET

curl --request GET \
  --url https://emailvalidation.cleariflow.com/v1

import requests

url = "https://emailvalidation.cleariflow.com/v1"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://emailvalidation.cleariflow.com/v1', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://emailvalidation.cleariflow.com/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://emailvalidation.cleariflow.com/v1"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://emailvalidation.cleariflow.com/v1")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://emailvalidation.cleariflow.com/v1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

Início rápido

Para fazer um pedido, forneça o seu api_key único e o email que pretende verificar — nada mais é necessário:

https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = jane.doe@acme-corp.com

O pedido é bem-sucedido e devolve todas as informações disponíveis sobre o endereço:

{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

Parâmetros de pedido

string

obrigatório

As suas credenciais pessoais de API. As chaves são limitadas por produto Cleariflow, pelo que uma chave de validação de email não autorizará pedidos a, por exemplo, a API de geolocalização IP.

String

obrigatório

O endereço de email que pretende verificar.

Boolean

Flag opcional para desativar a autocorreção. Defina auto_correct=false para a desligar. Está ativada por predefinição.

Parâmetros de resposta

As respostas são devolvidas como JSON compacto e padronizado.

String

Repete o email enviado no pedido.

String

Correção sugerida quando é detetado um provável erro de escrita (por exemplo, johnsmith@gmial.com => johnsmith@gmail.com). Vazio se não houver sugestão.

String

Avaliação da Cleariflow sobre se o endereço pode receber correio. Valores possíveis: DELIVERABLE, UNDELIVERABLE, UNKNOWN. DELIVERABLE exige verificação SMTP bem-sucedida; se existirem registros MX mas o SMTP não confirmar a caixa (comum em grandes provedores), o resultado é UNKNOWN. Todos os planos executam as mesmas verificações; os gratuitos diferem apenas na quota mensal e nos limites de taxa (ver códigos 422 e 429).

Float

Pontuação decimal de 0 a 0.99 que reflete a qualidade do endereço. Endereços descartáveis ficam limitados a cerca de 0.05; sem confirmação SMTP, máximo 0.55.

Boolean

true quando o endereço corresponde ao padrão local@domain.tld. Elementos em falta ou caracteres inválidos resultam em false.

Boolean

true se o domínio pertence a um fornecedor de email gratuito (por exemplo, Gmail, Yahoo).

Boolean

true se o domínio está na nossa lista de fornecedores de caixas de correio descartáveis/temporárias (por exemplo, Mailinator, Yopmail).

Boolean

true se a parte local parece ser uma conta de função e não de um indivíduo, por exemplo team@, sales@, info@.

Boolean

true se o domínio está configurado como catch-all.

Boolean

true quando existem registos MX para o domínio.

Boolean

true se a verificação SMTP for bem-sucedida. Se o SMTP falhar mas outras verificações passarem, o resultado pode ser UNKNOWN. Não recomendamos bloquear registos ou submissões de formulários apenas com base em falhas SMTP.

Exemplos de pedidos

Exemplo: provável erro de escrita

Este exemplo mostra um pedido em que é detetado um provável erro de escrita no endereço enviado. Mesmo quando é encontrado um provável erro de escrita, todas as outras verificações (por exemplo, email gratuito, domínio descartável) são realizadas sobre o endereço originalmente enviado — não sobre a correção sugerida.

https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith@gmial.con

Uma resposta bem-sucedida tem este aspeto:

{
  "email": "johnsmith@gmial.con",
  "autocorrect": "johnsmith@gmail.com",
  "deliverability": "UNKNOWN",
  "quality_score": 0.4,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": false,
    "text": "FALSE"
  },
  "is_smtp_valid": {
    "value": false,
    "text": "FALSE"
  }
}

Exemplo: formato inválido

Este exemplo demonstra um endereço que falha a formatação básica. Quando is_valid_format é false, verificações subsequentes (por exemplo, is_free_email, is_role_email) são ignoradas e reportadas como false.

https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith

Uma resposta bem-sucedida tem este aspeto:

{
  "email": "johnsmith",
  "autocorrect": "",
  "deliverability": "UNDELIVERABLE",
  "quality_score": 0.0,
  "is_valid_format": {
    "value": false,
    "text": "FALSE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": false,
    "text": "FALSE"
  },
  "is_smtp_valid": {
    "value": false,
    "text": "FALSE"
  }
}

Carregamento em massa (CSV)

Prefere não chamar a API diretamente? Utilize o carregador em massa CSV — os resultados serão enviados por email assim que o processamento terminar. Ao carregar um CSV, siga estas orientações:

Coloque os endereços de email na primeira coluna.
Elimine quaisquer linhas em branco.
Utilize um endereço por linha.
Limite os ficheiros a um máximo de 50.000 linhas.

Códigos de resposta e erro

Os erros são devolvidos em JSON com um código e descrição legível. Os códigos comuns estão listados abaixo.

Code	Type	Details
200	OK	Pedido concluído com sucesso.
400	Bad request	Pedido malformado ou inválido.
401	Unauthorized	Autenticação falhou — normalmente uma chave API em falta ou inválida.
422	Quota reached	Quota esgotada (por exemplo, créditos insuficientes em planos gratuitos).
429	Too many requests	Limite de taxa excedido (planos gratuitos permitem até 1 pedido/segundo).
500	Internal server error	Erro inesperado do nosso lado.
503	Service unavailable	Serviço temporariamente indisponível.

Outras notas

Nota sobre planos: todos os planos (gratuitos e pagos) executam as mesmas verificações, incluindo MX, SMTP e deteção catch-all. Nota de faturação: cada email avaliado consome um crédito por pedido — independentemente do resultado. Enviar um endereço inválido (por exemplo, “fda3346ds”) ainda conta como um crédito.

API de validação de telefonesAPI REST JSON rápida da Cleariflow para validação estrutural de telefones, normalização E.164 e detalhes opcionais de operadora, localização, fuso horário e marcação.

API de validação de email

curl --request GET \
  --url https://emailvalidation.cleariflow.com/v1

import requests

url = "https://emailvalidation.cleariflow.com/v1"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://emailvalidation.cleariflow.com/v1', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://emailvalidation.cleariflow.com/v1",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://emailvalidation.cleariflow.com/v1"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://emailvalidation.cleariflow.com/v1")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://emailvalidation.cleariflow.com/v1")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

Validação

Consulta

Criação

API de validação de email

Início rápido

Parâmetros de pedido

Parâmetros de resposta

Exemplos de pedidos

Exemplo: provável erro de escrita

Exemplo: formato inválido

Carregamento em massa (CSV)

Códigos de resposta e erro

Outras notas

​Início rápido

​Parâmetros de pedido

​Parâmetros de resposta

​Exemplos de pedidos

​Exemplo: provável erro de escrita

​Exemplo: formato inválido

​Carregamento em massa (CSV)

​Códigos de resposta e erro

​Outras notas

Início rápido

Parâmetros de pedido

Parâmetros de resposta

Exemplos de pedidos

Exemplo: provável erro de escrita

Exemplo: formato inválido

Carregamento em massa (CSV)

Códigos de resposta e erro

Outras notas