INICIO RÁPIDO DE LA API

COLECCIÓN POSTMAN

Para probar la versión 2 de la API en Postman, guarde el contenido de la colección Postman como un archivo .json o puede obtener el archivo de nuestro repositorio de GitHub .

En Postman, en el menú superior, haga clic en Archivo y luego seleccione Importar. Luego elija el archivo JSON que guardó o descargó de GitHub para importarlo.

Archivo JSON de la Colección Postman:

La API de validación de correo electrónico de ZeroBounce funciona tanto en tiempo real como de forma masiva. Si necesita verificar los correos electrónicos de manera constante y desea ahorrar tiempo y automatizar el proceso, le recomendamos que utilice la función de volumen.

La API detecta más de 30 tipos de direcciones de correo electrónico riesgosas, evita que se incluyan en su lista y ayuda a mantener la higiene de su correo electrónico durante un período de tiempo más largo. Una lista de correo electrónico saludable respalda su reputación de remitente y es la piedra angular de una buena capacidad de entrega de correo electrónicoⓘ.

Active la API hoy mismo instalándola en sus formularios de registro y suscripción, o dondequiera que recopile direcciones de correo electrónico en línea.

¿Necesita ayuda para comenzar con la API de validación de correo electrónico? Póngase en contacto con nuestro equipo de atención al cliente. Estamos aquí para responder a sus preguntas y ayudarle todo el día los 365 días del año.

Para activar los subtítulos en español (CC)
Haga clic en el ícono de engranaje
Luego, seleccione "subtítulos (CC)"
Elija "traducción automática​​​​​​​"
Seleccione "español​​​​​​​"

Esta API le dirá cuántos créditos le quedan en su cuenta. Es simple, rápido y fácil de usar.

Aquí hay algunos escenarios en los que las empresas deberían usar esta API:

• Cuando utilices nuestra API para validar correos electrónicos, revisa periódicamente tu saldo de créditos para evitar interrupciones del servicio por falta de créditos.
• Haz un seguimiento de cuántos créditos de validación de correos electrónicosⓘ estás utilizando dentro del período de tiempo que hayas definido para generar información estadística útil.
• Automatiza e integra en el panel de tu aplicación la información que te muestra tu saldo actual de créditos restantes.

A continuación, encontrarás las instrucciones sobre cómo usar nuestra API. Es muy fácil de usar y requiere SSL.

OBTENER /V2/GETCREDITS

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/getcredits

URL de API de U.S.A.*: https://api-us.zerobounce.net/v2/getcredits

URL de API de EU https://api-eu.zerobounce.net/v2/getcredits

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

A continuación, encontrarás las instrucciones sobre cómo usar nuestra API. Es muy fácil de usar y requiere SSL. La API requiere un saldo activo de créditos y nunca consumirá un crédito por un resultado desconocido.

OBTENER SALDO DE CRÉDITO (V2)

Esta API le dirá cuántos créditos le quedan en su cuenta. Es simple, rápido y fácil de usar.

Si deseas llamar a la API desde tu navegador para probarla, todo lo que tienes que hacer es reemplazar la CLAVE API con tu clave:

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/getcredits?api_key=[replacewithyours]

URL de API de U.S.A.*: https://api-us.zerobounce.net/v2/getcredits?api_key=[replacewithyours]

URL de API de EU https://api-eu.zerobounce.net/v2/getcredits?api_key=[replacewithyours]

Esta API le dirá cuántos créditos le quedan en su cuenta.

La API devolverá estos resultados en formato JSON utilizando el método "getcredits". ‘Credits’ es el valor que muestra la cantidad de créditos restantes en tu cuenta para validaciones de correos electrónicos. Si se devuelve un -1, eso significa que tu clave API no es válida.

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

Esta API le dirá cuántos créditos le quedan en su cuenta. Es simple, rápido y fácil de usar.

Respuesta exitosa

    {"Credits":2375323}

Respuesta de Error

    {"Credits":-1}

GetCredits V2 Límites

Permitimos un máximo de 80,000 solicitudes en 1 hora antes de bloquear temporalmente durante 1 día los siguientes endpoints:

• https://api.zerobounce.net/v2/getcredits
• https://api-us.zerobounce.net/v2/getcredits
• https://api-eu.zerobounce.net/v2/getcredits

Solicitudes con clave API incorrecta (200 veces en 1 hora) a los siguientes endpoints resultarán en un bloqueo temporal de 1 día:

• https://api.zerobounce.net/v2/getcredits
• https://api-us.zerobounce.net/v2/getcredits
• https://api-eu.zerobounce.net/v2/getcredits

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

GET /V2/GETAPIUSAGE

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/getapiusage

URL de API de U.S.A.*: https://api-us.zerobounce.net/v2/getapiusage

URL de API de EU: https://api-eu.zerobounce.net/v2/getapiusage

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

https://api.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

https://api-us.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

https://api-eu.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

La API devolverá estos resultados en formato JSON utilizando el método "getapiusage".

OBTENER MUESTRAS DE CÓDIGO GET API USAGE

Respuesta exitosa

 {
      "total": 120,
      "status_valid": 17,
      "status_invalid": 69,
      "status_catch_all": 9,
      "status_do_not_mail": 16,
      "status_spamtrap": 0,
      "status_unknown": 6,
      "sub_status_toxic": 0,
      "sub_status_disposable": 1,
      "sub_status_role_based": 1,
      "sub_status_possible_trap": 0,
      "sub_status_global_suppression": 14,
      "sub_status_timeout_exceeded": 0,
      "sub_status_mail_server_temporary_error": 0,
      "sub_status_mail_server_did_not_respond": 0,
      "sub_status_greylisted": 6,
      "sub_status_antispam_system": 0,
      "sub_status_does_not_accept_mail": 27,
      "sub_status_exception_occurred": 0,
      "sub_status_failed_syntax_check": 20,
      "sub_status_mailbox_not_found": 12,
      "sub_status_unroutable_ip_address": 0,
      "sub_status_possible_typo": 0,
      "sub_status_no_dns_entries": 10,
      "sub_status_role_based_catch_all": 0,
      "sub_status_mailbox_quota_exceeded": 0,
      "sub_status_forcible_disconnect": 0,
      "sub_status_failed_smtp_connection": 0,
      "sub_status_leading_period_removed": 0,
      "sub_status_alias_address": 2,
      "sub_status_mx_forward": 0,
      "sub_status_alternate": 0,
      "sub_status_blocked": 0,
      "sub_status_allowed": 0,
      "start_date": "1/1/2023",
      "end_date": "1/30/2024"
    }

Respuesta de error - clave de API

    {"error":"Invalid API Key"}

Respuesta de error - Fecha

    {"error":"Invalid Date"}

GetApiUsage V2 Límites

Las solicitudes incorrectas a 200 veces en 1 hora resultarán en un bloqueo temporal de 1 hora.

• https://api.zerobounce$.net/v2/getapiusage
• https://api-us.zerobounce.net/v2/getapiusage
• https://api-eu.zerobounce$.net/v2/getapiusage

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

Para activar los subtítulos en español (CC)
Haga clic en el ícono de engranaje
Luego, seleccione "subtítulos (CC)"
Elija "traducción automática​​​​​​​"
Seleccione "español​​​​​​​"

A continuación se encuentran las instrucciones para nuestra API de validación de un solo correo electrónico, que requiere SSL. La API también requiere que tengas un saldo activo de créditos y nunca consumirá un crédito por un resultado desconocido. Este endpoint puede llamarse de forma asíncrona y actualmente no tiene límite de tasa.

Para probar nuestro API sin usar créditos – Por favor use los correos electrónicos proporcionados en nuestro Modo Sandbox (v2).

El tiempo de respuesta de nuestra API está entre uno y treinta segundos. Dado que las API están diseñadas para ser rápidas por naturaleza, limitamos el tiempo que dedicamos a validar una dirección de correo electrónico. Si encontramos un servidor de correo lento o un servidor con un algoritmo de greylisting, obtendrás un resultado desconocido. Siempre puedes volver a validar esas condiciones subiendo un archivo a la validador de correo electrónico masivo.

En promedio, el 96-98% de todos los dominios responderán entre 1 y 5 segundos. Hay algunos dominios que utilizan Postfix/Dovecot, que tienen un tiempo de conexión de 20 segundos para validaciones en tiempo real, y una fracción muy pequeña de otros dominios que responden lentamente a consultas SMTP. Todos los principales ISP responderán entre 1 y 3 segundos, lo cual representa típicamente la mayoría de la distribución de correos electrónicos.

GET /V2/VALIDATE

URL DE API POR DEFECTO: https://api.zerobounce.net/v2/validate

URL de API de U.S.A.*: https://api-us.zerobounce.net/v2/validate

URL de la API de la UE: https://api-eu.zerobounce.net/v2/validate

A continuación se encuentran las instrucciones para nuestra API de validación de un solo correo electrónico, que requiere SSL. La API también requiere que tengas un saldo activo de créditos y nunca consumirá un crédito por un resultado desconocido. Este endpoint puede llamarse de forma asíncrona y actualmente no tiene límite de tasa.

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

Si deseas llamar a la API desde tu navegador para probarla, solo necesitas reemplazar la CLAVE API con tu clave:

https://api.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145

https://api-us.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145

https://api-eu.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145

PARA VERIFICAR UNA DIRECCIÓN DE CORREO ELECTRÓNICO, UTILICE LOS SIGUIENTES CÓDIGOS PARA LOS SIGUIENTES LENGUAJES:

    {
        "address":"flowerjill@aol.com",
        "status":"valid",
        "sub_status":"",
        "free_email":true,
        "did_you_mean":null,
        "account":"flowerjill",
        "domain":"aol.com",
        "domain_age_days": "8426",
        "active_in_days": "365",
        "smtp_provider":"yahoo",
        "mx_record":"mx-aol.mail.gm0.yahoodns.net",
        "mx_found": "true",
        "firstname":"Jill",
        "lastname":"Stein",
        "gender":"female",
        "country":"United States",
        "region":"Florida",
        "city":"West Palm Beach",
        "zipcode":"33401",
        "processed_at":"2017-04-01 02:48:02.592"
        }
    

Respuesta de error

    {"error":"Invalid API Key or your account ran out of credits"}
    // Failure response sample using the API with either method Get
    

LA API DEVOLVERÁ ESTOS RESULTADOS EN FORMATO JSON USANDO EL MÉTODO "VALIDATE".

Validación API V2 Límites

Permitimos un máximo de 80,000 solicitudes en 10 segundos (validaciones) para los siguientes endpoints:

• https://api.zerobounce.net/v2/validate
• https://api-us.zerobounce.net/v2/validate
• https://api-eu.zerobounce.net/v2/validate

Superar este límite resultará en un bloqueo temporal de 1 minuto.

Solicitudes con clave API incorrecta (200 veces en 1 hora) a los siguientes endpoints resultarán en un bloqueo temporal de 1 hora:

• https://api.zerobounce.net/v2/validate
• https://api-us.zerobounce.net/v2/validate
• https://api-eu.zerobounce.net/v2/validate

*Este punto final utiliza servidores ubicados en los Estados Unidos. Al utilizar este punto final, reconoces y consientes que tus datos serán procesados en servidores en los Estados Unidos.

Si necesita un aumento más allá de los límites de tasa predeterminados, por favor contacte a nuestro equipo de soporte para discutir sus necesidades.

La característica de validación de listas grises le permite validar dominios incluidos en listas grises directamente con la API de ZeroBounce. Cuando usted reciba un resultado desconocido/de inclusión en lista gris durante la validación, se volverá a procesar el correo electrónico para proporcionar un resultado.

Existen dos opciones para habilitar y utilizar esta funcionalidad:

1. Recolectar

Para utilizar la opción Recolectar, agregue el siguiente parámetro al normal /v2/validate call:

Usted puede volver a intentar la solicitud de validación después de 30 minutos, incluyendo el nuevo parámetro para obtener un resultado.

En el caso de solicitudes duplicadas, se exhibirá un mensaje de error en el que se sugerirá que vuelva a intentarlo más tarde.
{"Mensaje:": "Validación de listas grises aún en progreso. Vuelva a intentarlo más tarde."}

ZeroBounce resta créditos después de completar una recolección.

2. Webhook

Para crear un webhook, agregue los siguientes dos parámetros al normal /v2/validate call:

Para los webhooks, se permiten solicitudes duplicadas. Si efectúa la misma solicitud dos veces, puede esperar dos callbacks. Cada callback se cobrará.

Cuando se haya completado el procesamiento de listas grises, enviaremos una solicitud HTTP a su callback_url con el resultado.

ZeroBounce resta créditos ante una callback completada a la callback_url.

Consideraremos que se ha completado la callback si la respuesta de su punto de enlace tiene el código de estado 200 o 201.

El Verificador de Disponibilidad de Sitios Web y WHOIS mejora el proceso de validación de correos electrónicosⓘ al incluir verificaciones de disponibilidad de sitios web y la recuperación de datos WHOIS para dominios. Puedes controlar la nueva funcionalidad mediante el parámetro domain_info. Influirá en la respuesta de validación al agregar u omitir campos específicos según su valor.

Campos de Respuesta

Cuando el parámetro domain_info está configurado en true, la respuesta incluirá los campos adicionales 'domain_website_exists' y 'domain_registrant_company_name'. Si el parámetro 'domain_info' está en false o no se proporciona, estos campos no aparecerán en la respuesta.

Notas de Uso

Para usar la función de Verificador de Disponibilidad de Sitios Web y WHOIS, asegúrate de implementar lo siguiente:

Si tienes alguna pregunta o encuentras dificultades al usar el verificador WHOIS, comunícate con nuestro soporte al cliente por chat en vivo, disponible 24/7.

Este punto final le permite enviarnos lotes de hasta 200 correos electrónicos a la vez. Tiene un límite de tráfico de 5 usos por minuto, si excede el límite de tráfico, será bloqueado durante 10 minutos. Si desea realizar validaciones de correo electrónico individuales, por favor utilice nuestro punto final de validación de correo electrónico único.

Si desea cargar archivos con correos electrónicos superiores a 200 a la vez sin restricciones de limitación de tráfico, por favor utilice nuestros ,Puntos Finales de Administración de Archivos Masivos, que también incluyen anti-greylisting como beneficio añadido.

Este punto final puede tardar hasta 70 segundos en devolver los resultados de todo el lote. Actualmente no tenemos un SDK para este punto final, pero los SDK están disponibles para nuestros otros puntos finales.

- POST /V2/VALIDATEBATCH

API URL:

• api.zerobounce.net/v2/validatebatch
• api-us.zerobounce.net/v2/validatebatch
• api-eu.zerobounce.net/v2/validatebatch

A continuación, encontrará las instrucciones sobre cómo usar nuestra API, es muy fácil de usar y requiere SSL. La API requiere que tenga un saldo de crédito activo y nunca consumirá un crédito por cualquier resultado desconocido.

SOLICITUD DE EJEMPLO DE PUBLICACIÓN

    {
      "api_key":"Your API Key",
          "email_batch":[
              {"email_address": "valid@example.com","ip_address": "1.1.1.1"},
              {"email_address": "invalid@example.com","ip_address": "1.1.1.1"},
              {"email_address": "disposable@example.com","ip_address": null}
          ],
      "activity_data" : true,
      "verify_plus": true
  }
    

PARA USAR ESTE PUNTO FINAL, USE LOS EJEMPLOS DE CÓDIGO A CONTINUACIÓN PARA EL LENGUAJE DESEADO:

    {
      "email_batch": [
          {
              "address": "valid@example.com",
              "status": "valid",
              "sub_status": "",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.829"
          },
          {
              "address": "invalid@example.com",
              "status": "invalid",
              "sub_status": "mailbox_not_found",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.830"
          },
          {
              "address": "disposable@example.com",
              "status": "do_not_mail",
              "sub_status": "disposable",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.830"
          }
      ],
      "errors": []
  }
    

Respuesta de error

    {
      "email_batch": [],
      "errors": [
          {
              "error": "Invalid API Key or your account ran out of credits",
              "email_address": "all"
          }
      ]
    }
    

LA API DEVOLVERÁ UN OBJETO JSON CON 2 VALORES DE MATRIZ, "EMAIL_BATCH" Y "ERRORS" USANDO EL MÉTODO "BATCHVALIDATE".

La propiedad email_batch será una matriz de resultados validados y la matriz de errores será una matriz de errores encontrados durante la validación del lote, si los hubiera.

El validador de correo electrónico ZeroBounce permite que los usuarios creen filtros personalizados para permitir o bloquear correos electrónicos, dominios de correo electrónico, registros mx específicos o TLD (Dominio de Nivel Superior). La elaboración de estas listas blancas y listas negras le permitirá personalizar su experiencia de validación de correo electrónico según sus necesidades.

La creación de estos filtros personalizados simplifica la validación de correo electrónico al permitir o bloquear automáticamente valores y mejorar la eficacia de la validación de lista de correo electrónico.

Para crear sus reglas de validación de correo electrónico, inicie sesión en su cuenta de ZeroBounce y visite las configuraciones de su cuenta.

En las configuraciones, encontrará dos campos desplegables obligatorios. Debe seleccionar un valor para ambos para crear una nueva regla correctamente.

Aviso importante: Antes de comenzar, debe saber que las reglas más específicas tendrán prioridad por sobre las menos específicas.

Por ejemplo:

Regla 1:Bloquear - Correo electrónico - prueba@ejemplo.com

Regla 2: Permitir - Dominio - ejemplo.com

Si necesita editar una regla existente, puede hacerlo localizando la regla en su lista y haciendo clic en Modificar.

Al hacerlo, su regla aparecerá en el campo de personalización de arriba. Luego puede cambiar la regla de Permitir a Bloquear o viceversa.

Si desea editar el Objetivo o Valor, borre la regla de su lista y cree una nueva. Puede hacerlo haciendo clic en Borrar. Aparecerá una pantalla de confirmación para prevenir cambios de reglas accidentales en su cuenta.

Luego, puede crear una nueva regla que contenga la Regla, Objetivo y Valorcorrespondientes.

Si tiene problemas al crear sus reglas personalizadas de permitir o bloquear, comuníquese con el equipo de asistencia de ZeroBounce, disponible 24/7 por teléfono, correo electrónico o chat en vivo.

Para ayudarle a probar todos los escenarios de códigos de estado y subestado con la API, reunimos una lista de correos electrónicos que devolverán resultados específicos cuando se utilicen con la API con fines de prueba. Probar con estos correos electrónicos no usará ninguno de sus créditos.

Además, también proporcionamos una dirección IP para realizar pruebas y obtener resultados de ubicación geográfica.

Aún necesitará usar su CLAVE API con estas direcciones de correo electrónico de prueba.

• disposable@example.com
• invalid@example.com
• valid@example.com
• toxic@example.com
• donotmail@example.com
• spamtrap@example.com
• abuse@example.com
• unknown@example.com
• catch_all@example.com
• antispam_system@example.com
• does_not_accept_mail@example.com
• exception_occurred@example.com
• failed_smtp_connection@example.com
• failed_syntax_check@example.com
• forcible_disconnect@example.com
• global_suppression@example.com
• greylisted@example.com
• leading_period_removed@example.com
• mail_server_did_not_respond@example.com
• mail_server_temporary_error@example.com
• mailbox_quota_exceeded@example.com
• mailbox_not_found@example.com
• no_dns_entries@example.com
• possible_trap@example.com
• possible_typo@example.com
• role_based@example.com
• timeout_exceeded@example.com
• unroutable_ip_address@example.com
• free_email@example.com
• role_based_catch_all@example.com

Puede usar esta IP para probar la ubicación GEO en la API.

99.110.204.1

Consulte nuestra documentación de códigos de estado para obtener más información sobre cada estado.

EXPLICACIÓN DEL ESTADO DE ENTREGABILIDAD

• Válido - Estos son correos electrónicos que hemos determinado que son válidos y seguros para enviar por correo electrónico, tendrán una tasa de rebote muy baja de menos del 2%. Si recibe rebotes, puede ser porque su IP podría estar en la lista negra donde nuestra IP no estaba. A veces, las cuentas de correo electrónico existen, pero solo aceptan correo de personas en sus listas de contactos. A veces, se limitará la cantidad de correos electrónicos que puede enviar a un dominio específico por hora. Es importante mirar los códigos de rebote SMTP para determinar por qué.
• Inválido - estos son correos electrónicos que hemos determinado que no son válidos, por favor elimínelos de su lista de correo.
• Atrapatodo - Estos correos electrónicos son imposibles de validar sin enviar un correo electrónico real y esperar un rebote. El término Atrapatodo significa que el servidor de correo electrónico le dice que el correo electrónico es válido, ya sea válido o no válido. Si desea enviar estas direcciones por correo electrónico, le sugiero que las segmente en un grupo atrapatodo y sepa que es muy probable que algunas de ellas reboten.
• Trampa de spam - Se cree que estos correos electrónicos son trampas de spam y no deben enviarse por correo. Contamos con la tecnología para determinar si ciertos correos electrónicos deben clasificarse como trampas de spam. No conocemos todas las direcciones de correo electrónico de trampas de spam, pero conocemos muchas de ellas. Lea nuestra Guía de trampas de spam para obtener más información.
• Abuso - Estos correos electrónicos son de personas que se sabe que hacen clic en los enlaces de abuso en los correos electrónicos, por lo tanto, abusadores o denunciantes. Recomendamos no enviar correos electrónicos a estas direcciones.
• DoNotMail - Estos correos electrónicos son de empresas, basados en roles o de personas a las que simplemente desea evitar enviar correos electrónicos. Se dividen en 2 subcategorías "basado en roles" y "possible_trap". Examine este archivo y determine si desea enviar esta dirección por correo electrónico. Son direcciones de correo electrónico válidas, pero no se deben enviar por correo en la mayoría de los casos.
• Desconocido - Estos correos electrónicos no pudimos validar por una razón u otra. Los casos típicos son "Su servidor de correo no funciona" o "el sistema anti-spam nos está bloqueando". En la mayoría de los casos, el 80% de las incógnitas son direcciones de correo electrónico incorrectas o no válidas. Tenemos las "incógnitas" más bajas de cualquier validador de correo electrónico, y no hacemos esta afirmación a la ligera. Pagamos y probamos listas de correo electrónico en más de 50 empresas de validación diferentes para comparar los resultados. Si encuentra una gran cantidad de incógnitas, por favor envíelas para revalidación. Recuerde que no se le cobrará por resultados desconocidos, los créditos se le devolverán. Si aún tiene un gran número, póngase en contacto con nosotros y vamos a echar un vistazo y verificar.

También proporcionamos un código de subestado para ayudar a explicar algunos de los resultados desconocidos e inválidos, no todos los desconocidos e inválidos tendrán códigos de subestado.

EXPLICACIÓN DEL SUBESTADO

• alias_address - (Válido) Estas direcciones de correo electrónico actúan como reenviadores / alias y no son bandejas de entrada reales, por ejemplo, si envía un correo electrónico a forward@example.com y luego el correo electrónico se reenvía a realinbox@example.com. Es una dirección de correo electrónico válida y puede enviarles, es sólo un poco más de información sobre la dirección de correo electrónico. A veces podemos detectar direcciones de correo electrónico de alias y cuando lo hacemos se lo hacemos saber.
• antispam_system - (Desconocido) Estos correos electrónicos tienen implementados sistemas anti-spam que nos impiden validar estos correos electrónicos. Puede enviarnos estos a través de la pantalla de contacto para ver.
• does_not_accept_mail - (Inválido) Estos dominios solo envían correo y no lo aceptan.
• exception_ocurred - (Desconocido) Estos correos electrónicos provocaron una excepción al validar. Si esto sucede repetidamente, háganoslo saber.
• failed_smtp_connection - (Desconocido) Estos correos electrónicos pertenecen a un servidor de correo que no permite una conexión SMTP. La mayoría de las veces, estos correos electrónicos terminarán siendo inválidos.
• failed_syntax_check - (Inválido) Correos electrónicos que fallan los protocolos de sintaxis RFC
• forcible_disconnect - (Desconocido) Estos correos electrónicos pertenecen a un servidor de correo que se desconecta inmediatamente al conectarse. La mayoría de las veces, estos correos electrónicos terminarán siendo inválidos.
• global_supression - (do_not_mail) Estos correos electrónicos se encuentran en muchas listas populares de supresión global (GSL), consisten en denunciantes de ISP conocidos, denunciantes directos, direcciones compradas, dominios que no envían correo y litigantes conocidos.
• greylisted - (Desconocido) Correos electrónicos que no podemos validar temporariamente. Muchas veces, si vuelve a enviar estos correos electrónicos, se validarán en una segunda pasada.
• leading_period_removed - (Válido) Si una dirección de correo electrónico de gmail.com válida comienza con un punto "." lo eliminaremos, por lo que la dirección de correo electrónico es compatible con todos los sistemas de correo.
• mail_server_did_not_respond - (Desconocido) Estos correos electrónicos pertenecen a un servidor de correo que está devolviendo un error temporario. La mayoría de las veces, estos correos electrónicos terminarán siendo inválidos.
• mailbox_quota_exceeded - (Inválido) Estos correos electrónicos excedieron su cuota de espacio y no aceptan correos electrónicos. Estos correos electrónicos están marcados como inválidos.
• mailbox_not_found - (Inválido) Estas direcciones de correo electrónico son válidas en sintaxis, pero no existen. Estos correos electrónicos están marcados como inválidos.
• no_dns_entries - (Inválido) Estos correos electrónicos son válidos en sintaxis, pero el dominio no tiene ningún registro en DNS o tiene registros DNS incompletos. Por lo tanto, los programas de correo no podrán o tendrán dificultades para enviarles mensajes. Estos correos electrónicos están marcados como no válidos.
• possible_trap - (No enviar correo) Estos correos electrónicos contienen palabras clave que pueden correlacionarse con posibles trampas de spam como spam@ o @spamtrap.com. Examínelos antes de decidir enviarles correos electrónicos o no.
• possible_typo - (Inválido) Estos son correos electrónicos de dominios populares comúnmente mal escritos. Estos correos electrónicos están marcados como no válidos.
• role_based - (No enviar correo) Estos correos electrónicos pertenecen a una posición o un grupo de personas, como sales@ info@ y contact@. Los correos electrónicos basados en roles tienen una fuerte correlación con las personas que reportan los correos electrónicos enviados como spam y abuso.
• role_based_catch_all- (do_not_mail) Estos correos electrónicos están basados ​​en roles y también pertenecen a un dominio catch_all.
• timeout_exceeded - (Desconocido) Estos correos electrónicos pertenecen a un servidor de correo que responde extremadamente lento. La mayoría de las veces, estos correos electrónicos terminarán siendo inválidos.
• unroutable_ip_address - (Inválido) Estos dominios de correo electrónico apuntan a una dirección IP no enrutable, estos están marcados como inválidos.
• desechable - (do_not_mail) Estos son correos electrónicos temporales creados con el único propósito de registrarse en sitios web sin dar su dirección de correo electrónico real. Estos correos electrónicos tienen una duración corta, de 15 minutos a aproximadamente 6 meses. Solo hay 2 valores (Verdadero y Falso). Si tiene correos electrónicos válidos con esta bandera establecida en VERDADERO, no debe enviarlos por correo electrónico.
• tóxico (válido) Estos correos electrónicos son válidos, pero es probable que sean direcciones secundarias para los usuarios. Los correos electrónicos alternativos se utilizan a menudo para registrarse en cuentas, de lo contrario, solo verás poco engagement. A diferencia de las direcciones de correo electrónico principales, que se verían más oficial, los correos electrónicos alternativos generalmente contendrá números o más caracteres especiales, por ejemplo 12j.o-hn2023@gmail.com. La identificación de direcciones de correo electrónico alternativas permite una mejor segmentación de listas de correo electrónico. Es más probable que interactúen con tu contenido los usuarios con correos electrónicos formales.
• accept_all - (válido) Estas direcciones pertenecen a dominios en la lista accept_all de ZeroBounce. El servidor de correo de destino está configurado para aceptar cualquier destinatario y nunca emitir un rebote SMTP (por ejemplo, amazon.com, zerobounce.net). Debido a que los datos de envío a largo plazo muestran una tasa de rebote excepcionalmente baja (< 2 %), los tratamos como Válidos mientras los marcamos con el subestado accept_all para que puedas segmentar o monitorear la interacción si lo deseas.
• role_based_accept_all- (válido) Estos correos electrónicos son basados en roles, pertenecen a un dominio catch_all y a dominios que están en la lista de aceptación total (accept_all) de ZeroBounce.

También proporcionamos otros campos adicionales que debe tener en cuenta antes de enviar un correo electrónico. Si alguno de sus correos electrónicos válidos tiene la bandera desechable o tóxica establecida en verdadero, le recomendamos que no los envíe por correo electrónico.

OTROS DOMINIOS

• free_email - [verdadero / falso] Si el correo electrónico proviene de un proveedor gratuito.
• mx_found - [verdadero/falso] ¿Tiene el dominio un registro MX?
• mx_record - El registro MX preferido del dominio.
• smtp_provider - El proveedor SMTP del correo electrónico o [nulo] (BETA).

Estos son los elementos que cambiaron entre v1 y v2.

Uso recomendado de la API

Uso recomendado del punto final de gestión de archivos

¿Ha activado nuestra API de validación de correo electrónico y le gustaría enviar su archivo?

La API sendfile le permite enviar un archivo para la validación masiva por correo electrónico. El tipo de contenido debe ser multipart/ form-data. Consulte el ejemplo de C # para obtener más detalles.

No hay restricciones sobre el tamaño del archivo, número de correos electrónicos o número de archivos que puede enviar utilizando este punto final. Siempre y cuando tenga los créditos en su cuenta para cubrir el númerl de correos electrónicos enviados en el archivo, su archivo será aceptado.

Considere activar AutoPay en su cuenta ZeroBounce y asegúrese de que nunca se quede sin créditos.

POST /V2/SENDFILE

API URL: https://bulkapi.zerobounce.net/v2/sendfile

Si se especificó un return_url en los Datos del Formulario Multipare durante la solicitud de envío del archivo, publicaremos los siguientes datos en la URL cuando se complete el proceso de validación.

    {
      "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
      "file_name": "Your file name.csv", 
      "upload_date": "2023-04-28T15:25:41Z" 
    }
    

MUESTRAS DE CÓDIGO ENVIAR ARCHIVO

RESPUESTA DE PUNTO FINAL

    {
      "success": true,
      "message": "File Accepted",
      "file_name": "Your file name.csv",
      "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff"
    }
    

Respuesta de error

    {
      "success": false,
      "error_message": "Error messages"
  }

La API de validación de correo electrónico de ZeroBounce es una de las herramientas más efectivas para mantener los datos incorrectos fuera de su lista. La API puede detectar y rechazar más de 30 tipos de direcciones de correo electrónico problemáticas, lo que ayuda a mantener la higiene de su correo electrónico.

¿Necesita ayuda para enviar su archivo para la validación de correo electrónico masivo? Háganoslo saber: nuestro equipo está disponible todo el día para ayudarle.

¿Le gustaría verificar el estado de un archivo que envió para la validación por correo electrónico a través de la API de ZeroBounce? Puede hacerlo en cualquier momento; por favor consulte nuestras instrucciones a continuación.

La API filestatus devuelve el estado de procesamiento del archivo para el archivo que se ha enviado utilizando la API sendfile. Consulte el ejemplo de C # para más detalles.

GET /V2/FILESTATUS

API URL: https://bulkapi.zerobounce.net/v2/filestatus

Si desea llamar a la API desde su navegador para probarlo, todo lo que tiene que hacer es reemplazar la CLAVE API con su clave API única y la ID DE ARCHIVO con la ID de archivo devuelta desde la API de sendfile:

https://bulkapi.zerobounce.net/v2/filestatus?api_key=[replacewithyours]&file_id=[replacewithyours]

MUESTRAS DE CÓDIGO DE ESTADO DE ARCHIVO

A continuación, puede encontrar ejemplos de respuestas exitosas y de error.

RESPUESTA DE PUNTO FINAL

  {
    "success": true,
    "file_id": "aaaaaaaa-zzzz-xxxx-yyyy-5003727fffff",
    "file_name": "Your file name.csv",
    "upload_date": "2023-04-28T15:25:41Z",
    "file_status": "Complete",
    "complete_percentage": "100%",
    "return_url": "Your return URL if provided when calling sendfile API"
  }
  

Respuesta de error

  {      
    "success": false,
    "error_message": "Error messages"
  }
  

El uso de la API de validación de correo electrónico es una forma eficaz de evitar que ingresen datos erróneos y de mala calidad en sus listas de correo electrónico. Puede utilizar la API de forma masiva o en tiempo real. Por cada dirección de correo electrónico que verifica, la API consume un crédito de su cuenta ZeroBounce. Si usa la API de manera constante, asegúrese de que su cuenta se reponga periódicamente con créditos.

¿Necesita ayuda para determinar el estado de sus archivos API de validación de correo electrónico? Comuníquese con nuestro equipo de atención al cliente. Estamos disponibles las 24 horas del día para responder cualquier pregunta y ayudarle.

¿Le gustaría obtener los resultados de la API de validación de correo electrónico? Por favor siga nuestras instrucciones a continuación.

La API getfile le permite obtener los resultados de la validación del archivo que envió utilizando la API sendfile. Consulte el ejemplo de C# para más detalles.

GET /V2/GETFILE

API URL: https://bulkapi.zerobounce.net/v2/getfile

Si desea llamar a la API desde su navegador para probarlo, todo lo que tiene que hacer es reemplazar la CLAVE de API con su clave de API y el ID de ARCHIVO con el ID de archivo devuelto por la API sendfile:

https://bulkapi.zerobounce.net/v2/getfile?api_key=replacewithyours&file_id=[replacewithyours]

O si desea que los Datos de Actividad se añadan al archivo de resultados, incluya activity_data=true:

https://bulkapi.zerobounce.net/v2/getfile?api_key=replacewithyours&file_id=[replacewithyours]&activity_data=true

EJEMPLOS DE CÓDIGO GETFILE

RESPUESTA DE PUNTO FINAL

  //N/A

La API getfile devuelve el archivo de resultados de validación. El tipo de contenido devuelto es "application/octet-stream". Puede obtener el nombre del archivo response.Content.Headers.ContentDisposition.FileName. Si llama a la API directamente desde el navegador, puede guardar o abrir el archivo de resultados desde el navegador.

Respuesta de error

  {
    "success": false,
    "error_message": "Error messages"
}  

La API de validación de correo electrónico de ZeroBounce se puede utilizar en tiempo real o de forma masiva - si necesita validar los correos electrónicos de forma coherente y desea automatizar el proceso. La API detecta más de 30 códigos de estado y subestadosde correo electrónico, lo que evita que se agreguen datos riesgosos y de mala calidad a su base de datos de correo electrónico.

¿Necesita ayuda para obtener los resultados de la API de validación de correo electrónico? Nuestro equipo está aquí para echar una mano. Comuníquese con nosotros en cualquier momento, ofrecemos atención al cliente 24/7.

¿Ha recuperado los resultados de la API de validación de correo electrónico y le gustaría eliminar su archivo? Ha venido al lugar correcto.

La API deletefile elimina el archivo que envió utilizando la API sendfile. Tenga en cuenta que el archivo sólo se puede eliminar cuando su estado es completo.

API URL: https://bulkapi.zerobounce.net/v2/deletefile

GET /V2/DELETEFILE

MUESTRAS DE CÓDIGO DELETEFILE

RESPUESTA DE PUNTO FINAL

Respuesta exitosa

{
  "success": true,
  "message": "File Deleted",
  "file_name": "test2",
  "file_id": "b222a0fd-90d5-416c-8f1a-9cc3851fc823"
}

Respuesta de error

{
  "success": false,
  "error_message": "File cannot be found."
}

La API de validación de correo electrónico de ZeroBounce mejora sus flujos de trabajo y le ahorra tiempo. La API devuelve 30 estados y subestados sobre los datos de correo electrónico en su lista. Puede usarlo tanto en tiempo real como de forma masiva, si desea programarlo y automatizar la verificación de su correo electrónico.

La API de ZeroBounce evita que se agreguen a su base de datos direcciones de correo electrónico erróneas y riesgosas. Detecta errores tipográficos, abusos, correos electrónicos basados en roles, correos electrónicos atrapatodo y trampas de spam, por nombrar sólo algunos. Una vez conectado a su formulario de registro, verifica el contacto de correo electrónico de cada nuevo suscriptor, manteniendo así sus datos precisos.

Si necesita ayuda para eliminar su archivo de API de validación de correo electrónico, háganoslo saber. Nuestro equipo está aquí 24/7 para responder cualquier pregunta y hacer las cosas más fáciles para usted.