Menu

Documentação

API de Verificação de E-mail

Verifique endereços de e-mail antes de escrever para eles. Assim os retornos diminuem e suas listas continuam limpas.

Verificação de e-mail
https://api.flowdata.one/v1/email-verification/{email}

Arquivo OpenAPI desta área

Início rápido

Chave FlowData
Esta API faz parte da FlowData e usa chaves próprias (fd_...), que você cria no dashboard em Chaves de API. Chaves FlowSuite (pk_..., at_...) continuam funcionando, mas recomendamos uma chave FlowData.
Chave somente no cabeçalho
Envie a chave somente no cabeçalho Authorization: Bearer fd_..., nunca na URL.
Serviços externos de verificação
Se nossas próprias verificações não forem conclusivas, o endereço é enviado a serviços de verificação conectados (Emailable, Hunter, Leadrocks).
Aviso de segurança
Nunca use chaves de API em código frontend. Em produção, encaminhe as requisições pelo seu próprio backend.

Visão geral

A API de Verificação de E-mail verifica um endereço em várias etapas e para assim que uma etapa dá um resultado claro:

  1. Sintaxe conforme RFC 5321/5322, incluindo domínios internacionalizados
  2. Resultado armazenado para o mesmo endereço, se ainda válido
  3. Servidor de e-mail do domínio (registros MX, null MX conforme RFC 7505, fallback A/AAAA)
  4. Domínios descartáveis e domínios catch-all conhecidos
  5. Verificação de caixa postal por serviços conectados

Também marca endereços de função como info@ ou financeiro@.

Endpoints da API

GET
/v1/email-verification/{email}

Verificar um endereço de e-mail

Verifica um endereço de e-mail. result é safe (entregável), risky (entregável, mas incerto), invalid (não entregável) ou unknown (não determinável, não cobrado). reason informa o motivo: accepted, catch_all, role_account, disposable, invalid_syntax, invalid_domain, null_mx, rejected, low_quality, unverifiable, processing_objected (o titular se opôs ao tratamento dos seus dados) ou dns_unavailable. checks contém as verificações individuais (sintaxe, servidor de e-mail, provedor, domínio descartável, endereço de função, catch-all). Os campos anteriores continuam: status é valid se é possível enviar para o endereço, caso contrário risky, invalid, disposable ou unknown. source mostra de onde vem o resultado: DB (resultado armazenado), NA (verificação própria) ou um serviço de verificação (LR, HU, EA). A API responde a um endereço sintaticamente inválido com HTTP 400.

Bearer fd_… 9,00 EUR por 1.000 requisições bem-sucedidas

Parâmetros de caminho

Nome Tipo Descrição
email string
Obrigatório
Endereço de e-mail a verificar
curl -X GET "https://api.flowdata.one/v1/email-verification/max@example.com" \
  -H "Authorization: Bearer fd_SUA_CHAVE" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_SUA_CHAVE')
    ->get('https://api.flowdata.one/v1/email-verification/max@example.com');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/email-verification/max@example.com', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_SUA_CHAVE',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/email-verification/max@example.com',
    headers=headers,
)

data = response.json()
{
    "email_address": "user@example.com",
    "status": "valid",
    "source": "NA",
    "result": "risky",
    "reason": "catch_all",
    "checks": {
        "syntax": true,
        "mx": "ok",
        "mail_provider": "other",
        "disposable": false,
        "role_account": false,
        "catch_all": true
    }
}

Recursos de validação

Sintaxe

  • Verificação conforme RFC 5321/5322
  • Domínios internacionalizados (IDN)
  • Limites de tamanho para endereço, parte local e domínio

Domínio

  • Registros MX e provedor de e-mail do domínio
  • Null MX (domínio não aceita e-mails)
  • Domínios sem servidor de e-mail
  • Domínios catch-all, depois que um serviço de verificação os detectou

Caixa postal

  • Verificação por serviços conectados, somente se nossas próprias verificações não forem conclusivas
  • Resultados armazenados são reaproveitados por 3 a 90 dias, conforme o resultado

Qualidade

  • Domínios descartáveis (lista atualizada semanalmente)
  • Endereços de função como info@, suporte@ ou financeiro@

Uma chave basta para começar.

Crie uma chave e chame a API. As informações do cliente são gratuitas; o restante é cobrado por solicitação bem-sucedida.

Criar chave de API Documentação

O FlowData é destinado exclusivamente a empresas e profissionais autônomos.