Documentación de API

Instrucciones de Verificación Instantánea

Introducción

¡Bienvenido a la API de Validación de Correo Electrónico Único de EmailVerify.io! Esta API te permite validar una única dirección de correo electrónico en tiempo real mediante una solicitud simple, garantizando precisión y fiabilidad en tus comunicaciones por correo.

Autenticación

Para acceder a la API, necesitas una clave API válida. Puedes generar tu clave personal en la sección de API después de iniciar sesión en tu cuenta. Esta clave es necesaria para la autenticación y para realizar solicitudes de forma segura.

Punto Final de la API

Valida una única dirección de correo electrónico reemplazando los marcadores de posición con tu clave API única y la dirección de correo electrónico a validar en la siguiente URL:

URL de Solicitud GET (HTTPS)


https://app.emailverify.io/api/v1/validate?key=yourapikey&email=valid@example.com

Ejemplo de Respuesta Exitosa

Recibirás una respuesta como esta si tu solicitud de correo electrónico único se procesa correctamente:

URL

{
  "email": "jhon123@gmail.com",
  "status": "valid"
}

Validaciones Realizadas en la Verificación de Correo Único

Validación Regex: Verifica la estructura de las direcciones de correo electrónico según los patrones regex estándar de la industria para detectar errores tipográficos y de formato antes del procesamiento adicional.

Validación MX: Comprueba los registros válidos de intercambio de correo (MX) para confirmar que el dominio del correo está configurado para recibir mensajes, asegurando que existe y está activo.

Validación de Lista Negra MX: Identifica dominios que figuran en listas negras conocidas por actividades de spam o maliciosas, ayudándote a evitar destinos de correo poco fiables o dañinos.

Validación SMTP: Realice una verificación en tiempo real haciendo ping al servidor SMTP del destinatario para confirmar que la dirección de correo electrónico está activa y puede recibir correos electrónicos.

Respuestas de Error

Mensaje de Error

Descripción

Clave API Inválida

Si la clave está deshabilitada o no existe

Solicitud Inválida

parámetros inválidos en el punto final de la API

0 créditos restantes

El usuario no tiene créditos disponibles

Por favor, inténtalo de nuevo

Cuando algo salió mal de nuestro lado

Consultar Saldo de la Cuenta

Por favor, utiliza la siguiente solicitud GET para consultar el saldo actual de la cuenta (créditos diarios e instantáneos restantes).

URL de Solicitud GET (HTTPS):


https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Aquí, reemplaza <Your_API_Key> con tu clave API activa.

Respuesta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "remaining_credits": 15000
}

Instrucciones de Verificación Masiva

Introducción

¡Bienvenido a la API de Verificación Masiva de Correos Electrónicos de EmailVerify.io! Esta API te permite validar hasta 5000 direcciones de correo electrónico en tiempo real mediante una solicitud sencilla, asegurando precisión y confiabilidad en tu comunicación por correo electrónico.

Este punto final te permite enviarnos lotes de hasta 5000 correos electrónicos a la vez. Si estás buscando validar correos de forma individual, por favor usa nuestro punto final para validación de correo único.

Autenticación

Para acceder a la API, necesitarás una clave API válida. Genera tu clave personal en la sección de API después de iniciar sesión en tu cuenta. Esta clave es necesaria para la autenticación y para realizar solicitudes de forma segura.

Punto Final de la API

Para validar tus direcciones de correo electrónico, reemplaza el marcador de posición con tu clave API única e incluye las direcciones de correo en el cuerpo de la

Solicitud POST.

URL de Solicitud POST (HTTPS)


https://app.emailverify.io/api/v1/validate-batch

Solicitud POST

Puedes validar hasta 5000 direcciones de correo electrónico enviándolas en la siguiente solicitud POST.

Solicitud POST

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "valid@example.com" },
    { "address": "invalid@example.com" },
    { "address": "catch_all@example.com" }
  ]
}

Ejemplo de Respuesta Exitosa

Recibirás una respuesta como esta cuando tu tarea de verificación masiva se cree correctamente.

URL

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

Solicitud GET

Este punto final recupera los resultados de una tarea de verificación masiva de correos electrónicos creada previamente. Los resultados incluirán el estado general de la tarea y, si ha finalizado, los resultados de la verificación.

URL de Solicitud GET


https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

Ejemplo de Respuesta Exitosa

Aquí tienes un ejemplo de respuesta una vez que se complete tu tarea de verificación:

Solicitud POST

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "valid@example.com",
        "status": "invalid"
      }
    ]
  }
}

Validaciones Realizadas en la Verificación Masiva de Correos

Validación MX: Comprueba los registros válidos de intercambio de correo (MX) para confirmar que el dominio del correo está configurado para recibir mensajes, asegurando que existe y está activo.

Validación de Lista Negra MX: Identifica dominios que figuran en listas negras conocidas por actividades de spam o maliciosas, ayudándote a evitar destinos de correo poco fiables o dañinos.

Respuestas de Error

Mensaje de Error

Descripción

Clave API Inválida

Si la clave API está deshabilitada o no existe.

Solicitud Inválida

Si la solicitud contiene parámetros inválidos.

0 créditos restantes

Si el usuario no tiene créditos disponibles.

Por favor, inténtalo de nuevo

Cuando algo salió mal de nuestro lado.

Consultar Saldo de la Cuenta

Por favor, utiliza la siguiente solicitud GET para consultar el saldo actual de la cuenta (créditos diarios e instantáneos restantes).

URL de Solicitud GET (HTTPS):


https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

Aquí, reemplaza <Your_API_Key> con tu clave API activa.

Respuesta (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "remaining_credits": 15000
}