Verificador de entregabilidad de correo API

Selecciona un tipo de tarea por carga: email_check para entregabilidad o email_avatar para avatares. Ambos utilizan el flujo asíncrono por lotes descrito a continuación.

Verificador de entregabilidad (email_check)

Comprueba si las direcciones de correo están activas y pueden recibir mensajes. Solo admite Gmail, Yandex, Mail.ru, iCloud, Outlook y Yahoo.

Verificador de avatar (email_avatar)

Comprueba si las direcciones de correo tienen un avatar público y devuelve su URL. Solo admite Gmail, Yandex y Mail.ru.

Las direcciones ajenas a los proveedores indicados y sus dominios alternativos admitidos se excluyen del procesamiento, los resultados y la facturación.

Formato de entrada

Sube un archivo de texto con una dirección de correo admitida por línea.

user@gmail.com
another@yandex.com

Crear una tarea

POST https://api.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="email_check"'

Verificador de avatar (email_avatar)

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="email_avatar"'

La API devuelve un ID de tarea. Guárdelo y úselo para consultar el estado.

Respuesta de carga

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Comprobar el estado de la tarea

POST https://api.numberchecker.ai/v1/gettasks

curl --location 'https://api.numberchecker.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Consulte hasta que status sea exported. No considere pending ni processing como resultados completos.

Respuesta en proceso

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Respuesta exportada

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

Campos del resultado

Verificador de entregabilidad (email_check)

Campo	Descripción	Ejemplo
email	Dirección de correo de la entrada enviada.	user@gmail.com
activated	Indica si la entrada se detectó como activa o registrada.	yes

Verificador de avatar (email_avatar)

Campo	Descripción	Ejemplo
email	Dirección de correo de entrada del archivo enviado.	user@gmail.com
activated	Indica si la dirección tiene un avatar público.	yes
avatar	URL de la imagen de avatar cuando está disponible; vacío si la cuenta usa el marcador de posición predeterminado.	https://…
name	Nombre visible cuando el proveedor lo expone; vacío en caso contrario.	John Doe

Procesamiento del archivo de resultados

Descargue el archivo desde result_url solo después de exportar la tarea. Conserve los nombres de columna devueltos al procesar el archivo.

Campos de respuesta

Campo	Descripción
created_at	Marca de tiempo de creación de la tarea.
updated_at	Marca de tiempo de la última actualización.
task_id	Identificador único de la tarea.
status	pending, processing, exported o failed.
total	Total de valores de entrada procesados.
success	Valores procesados correctamente.
failure	Valores cuyo procesamiento falló.
result_url	URL de descarga cuando la tarea se exporta.
actual_amount	Importe final liquidado, si está disponible.
estimated_amount	Importe estimado devuelto al crear la tarea.

Códigos de estado

Status	Descripción
200	Solicitud correcta.
202	Tarea creada correctamente y cargo estimado aplicado.
400	Archivo no válido, tipo de tarea no compatible o muy pocas entradas válidas.
401	Falta la clave API o no es válida.
402	Saldo insuficiente.
403	Producto no disponible para su cuenta (descontinuado o solo para clientes en lista blanca); contacte con soporte.
404	Tarea no encontrada.
413	El archivo cargado es demasiado grande.
500	Error interno del servidor; inténtelo más tarde.
503	Producto temporalmente no disponible (pausado por mantenimiento); no se realiza ningún cargo, inténtelo más tarde.

Notas operativas

• La tarea es asíncrona; use el ID para consultar su estado.
• Compruebe los límites de entrada del producto antes de cargar el archivo.
• Las filas fallidas aparecen en el resultado exportado y se reflejan en los contadores.
• Los campos anteriores se basan en el sample actual y pueden cambiar si cambia el esquema de exportación.