API de validación 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"
  }
}

Inicio rápido

Para hacer una solicitud, indique su api_key única y el email que desea verificar; no se requiere nada más:

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

La solicitud se completa correctamente y devuelve toda la información disponible sobre la dirección:

{
  "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 solicitud

string

requerido

Su credencial API personal. Las claves están limitadas por producto de Cleariflow, por lo que una clave de validación de email no autorizará solicitudes a, por ejemplo, la API de geolocalización IP.

String

requerido

La dirección de email que desea verificar.

Boolean

Indicador opcional para desactivar la autocorrección. Establezca auto_correct=false para desactivarla. Está habilitada de forma predeterminada.

Parámetros de respuesta

Las respuestas se devuelven en JSON compacto y estandarizado.

String

Devuelve el email enviado en la solicitud.

String

Corrección sugerida cuando se detecta un posible error tipográfico (p. ej., johnsmith@gmial.com => johnsmith@gmail.com). Vacío si no hay sugerencia.

String

Evaluación de Cleariflow sobre si la dirección puede recibir correo. Valores posibles: DELIVERABLE, UNDELIVERABLE, UNKNOWN. DELIVERABLE requiere una verificación SMTP exitosa; si existen registros MX pero SMTP no puede confirmar el buzón (común en grandes proveedores), el resultado es UNKNOWN. Todos los planes ejecutan las mismas comprobaciones; los gratuitos solo difieren en cuota mensual y límites de velocidad (véase códigos 422 y 429).

Float

Puntuación decimal (0,01–0,99) que indica nuestra confianza en la calidad y entregabilidad de la dirección.

Boolean

Verdadero cuando la dirección coincide con el patrón estándar local@domain.tld. Elementos faltantes o caracteres no válidos devuelven false.

Boolean

Verdadero si el dominio pertenece a un proveedor de email gratuito (p. ej., Gmail, Yahoo).

Boolean

Verdadero si el dominio está en nuestra lista de proveedores de buzones desechables/temporales (p. ej., Mailinator, Yopmail).

Boolean

Verdadero si la parte local parece ser una cuenta de rol en lugar de un individuo, p. ej., team@, sales@, info@.

Boolean

Verdadero si el dominio está configurado como catch‑all.

Boolean

Verdadero cuando existen registros MX para el dominio.

Boolean

Verdadero si la verificación SMTP tiene éxito. Si SMTP falla pero otras comprobaciones pasan, el resultado puede ser UNKNOWN. No recomendamos bloquear registros o envíos de formularios únicamente por fallos SMTP.

Ejemplos de solicitud

Ejemplo: posible error tipográfico

Este ejemplo muestra una solicitud en la que se detecta un posible error tipográfico en la dirección enviada. Incluso cuando se encuentra un posible error tipográfico, todas las demás comprobaciones (p. ej., email gratuito, dominio desechable) se realizan sobre la dirección enviada originalmente, no sobre la corrección sugerida.

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

Una respuesta exitosa tiene este aspecto:

{
  "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"
  }
}

Ejemplo: formato no válido

Este ejemplo demuestra una dirección que no supera el formato básico. Cuando is_valid_format es false, las comprobaciones posteriores (p. ej., is_free_email, is_role_email) se omiten y se informan como false.

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

Una respuesta exitosa tiene este aspecto:

{
  "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"
  }
}

Carga masiva (CSV)

¿Prefiere no llamar a la API directamente? Use el cargador masivo CSV: los resultados se le enviarán por email cuando finalice el procesamiento. Al cargar un CSV, siga estas directrices:

Coloque las direcciones de email en la primera columna.
Elimine las filas en blanco.
Use una dirección por fila.
Limite los archivos a un máximo de 50.000 filas.

Códigos de respuesta y error

Los errores se devuelven en JSON con un código y una descripción legible. Los códigos más comunes se enumeran a continuación.

Code	Type	Details
200	OK	Solicitud completada correctamente.
400	Bad request	Solicitud mal formada o no válida.
401	Unauthorized	Autenticación fallida, generalmente por una clave API faltante o no válida.
422	Quota reached	Cuota agotada (p. ej., créditos insuficientes en planes gratuitos).
429	Too many requests	Límite de velocidad superado (los planes gratuitos permiten hasta 1 solicitud/segundo).
500	Internal server error	Error inesperado en nuestro lado.
503	Service unavailable	Servicio temporalmente no disponible.

Otras notas

Nota sobre planes: todos los planes (gratuitos y de pago) ejecutan las mismas comprobaciones, incluidas MX, SMTP y detección catch-all. Nota de facturación: cada email evaluado consume un crédito por solicitud, independientemente del resultado. Enviar una dirección no válida (p. ej., “fda3346ds”) sigue contando como un crédito.

API de validación de teléfonoAPI REST JSON rápida de Cleariflow para validación estructural de teléfonos, normalización E.164 y datos opcionales de operador, ubicación, zona horaria y marcación.

API de validación 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"
  }
}

Validación

Consulta

Creación

API de validación de email

Inicio rápido

Parámetros de solicitud

Parámetros de respuesta

Ejemplos de solicitud

Ejemplo: posible error tipográfico

Ejemplo: formato no válido

Carga masiva (CSV)

Códigos de respuesta y error

Otras notas

​Inicio rápido

​Parámetros de solicitud

​Parámetros de respuesta

​Ejemplos de solicitud

​Ejemplo: posible error tipográfico

​Ejemplo: formato no válido

​Carga masiva (CSV)

​Códigos de respuesta y error

​Otras notas

Inicio rápido

Parámetros de solicitud

Parámetros de respuesta

Ejemplos de solicitud

Ejemplo: posible error tipográfico

Ejemplo: formato no válido

Carga masiva (CSV)

Códigos de respuesta y error

Otras notas