Versión 2: Primeros pasos

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.

Consulte los límites de tráfico de la API. 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.

• valid - Determinamos que estas direcciones son válidas y seguras para enviar correos electrónicos. Tendrán una tasa de rebote muy baja, inferior al 2%.
  Si recibe rebotes, podría ser que su IP esté en una lista negra mientras que la nuestra no. A veces, las cuentas de correo electrónico existen, pero solo aceptan correos de las personas que figuran en sus listas de contactos. En otros casos, es posible que usted tenga un límite 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é se produjo un rebote.
  • alias_address - (valid) Estas direcciones de correo electrónico actúan como reenviadoras/alias y no son buzones de entrada reales.
    Por ejemplo, si envía un correo electrónico a "forward@example.com", su correo electrónico se reenvía a "realinbox@example.com".
    Un alias es una dirección de correo electrónico válida, y su correo electrónico no rebotará. Este estado pretende proporcionar más información sobre la dirección de correo electrónico. A veces podemos detectar alias de direcciones de correo electrónico y, cuando lo hacemos, se lo comunicamos.
  • leading_period_removed - (valid) Si una dirección de correo electrónico válida de gmail.com comienza con un punto, '.', lo eliminaremos para que la dirección de correo electrónico sea compatible con todos los sistemas de correo.
  • alternate - (valid) Estos correos electrónicos son válidos, pero es probable que sean direcciones secundarias para los usuarios. Los correos electrónicos alternativos se suelen usar para suscribirse a cuentas, pero no son muy utilizados.
    A diferencia de las direcciones de correo electrónico primarias, que tienen un aspecto más formal, las alternativas suelen contener números o caracteres especiales, por ejemplo 12j.o-hn2023@gmail.com. Identificar direcciones de correo electrónico alternativas permite una mejor segmentación de la lista de correo electrónico. Los usuarios con correos electrónicos formales son más propensos a involucrarse con su contenido.
  • gold – (válidos): Son tus destinatarios de correo más activos y valiosos. Los hemos identificado como contactos de alto compromiso que abren, hacen clic e interactúan con los correos de forma constante. Priorizar a estos contactos puede ayudarte a mejorar tu reputación como remitente.
  • role_based_accept_all - Estos correos electrónicos están basados en funciones, pertenecen a un dominio de tipo 'catch-all' y forman parte de dominios en la lista 'accept_all' de ZeroBounce.
  • 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.
  ¿En qué se diferencia esto del estado independiente “Catch-all”?
  • accept_all ➜ Dominio verificado por ZeroBounce, con historial de entregabilidad, devuelto como válido;
  • catch-all ➜ Dominio no está en la lista permitida; la entregabilidad real no se puede confirmar;
• invalid - Estos son los correos electrónicos que determinamos que no son válidos. Elimínelos de su lista de correo electrónico. El correo electrónico puede ser considerado inválido por varias razones, como "buzón no encontrado". También es posible que la dirección no acepte correos electrónicos.A continuación se muestra una lista de códigos de subestado para ayudar a explicar algunos de los resultados no válidos.
  • does_not_accept_mail - (invalid) Estos dominios solo envían correo electrónico y no lo aceptan.
  • failed_syntax_check - (invalid) Correos electrónicos que incumplen los protocolos de sintaxis de RFC.
  • possible_typo - (invalid) Se trata de correos electrónicos pertenecientes a dominios conocidos, comúnmente mal escritos.
  • mailbox_not_found - (invalid) Estas direcciones de correo electrónico son válidas en la sintaxis, pero no existen.
  • no_dns_entries - (invalid) Estos correos electrónicos son válidos en sintaxis, pero el dominio no tiene ningún registro DNS o tiene registros DNS incompletos. Por lo tanto, los programas de correo electrónico tendrán dificultades o no podrán entregarles los correos electrónicos.
  • mailbox_quota_exceeded - (invalid) Estas direcciones superaron su cuota de espacio y ya no aceptan correos electrónicos (temporalmente).
  • unroutable_ip_address - (invalid) Estos dominios de correo electrónico apuntan a una dirección IP imposible de enrutar.
• catch-all - Estos correos electrónicos son imposibles de validar sin enviar un correo electrónico real y esperar un rebote. "Catch-all" significa que el servidor de correo electrónico le dice que el correo electrónico es válido, tanto si es válido como si no lo es. Si desea enviar correos electrónicos a estas direcciones, le sugerimos que las segmente en un grupo general con el conocimiento de que algunos de sus correos electrónicos rebotarán.
  Conozca más sobre los correos electrónicos "catch-all"
• spamtrap - Se cree que estos correos electrónicos son trampas de spam, y no debería enviarles correos electrónicos. Disponemos de la tecnología necesaria para determinar si ciertos correos electrónicos deben clasificarse como trampas de spam. No conocemos todas las direcciones de correo electrónico que son trampas de spam, pero sí muchas de ellas.
  Lea nuestra guía sobre trampas de spam para conocer más.
• abuse - Estos correos electrónicos son de personas conocidas por hacer clic en los enlaces a abusos en los correos electrónicos, es decir, abusadores o reclamantes. Recomendamos no enviar correos electrónicos a estas direcciones.
• No_enviar_correo_electrónico - Se trata de correos corporativos, basados en roles o simplemente direcciones a las que debería evitar escribir. Se dividen en 7 subcategorías: "disposable", "toxic", "role_based", "role_based_catch_all", "global_suppression", "mx_forward" y "possible_trap". Examine este archivo y determine si desea enviar correos a estas direcciones.

  Direcciones de correo válidas (pero no deberían usarse para enviar correos en la mayoría de los casos):

  • role_based - (do_not_mail) Estas direcciones pertenecen a un puesto o a un grupo de personas, como sales@, info@ y contact@. Los correos electrónicos basados en funciones están fuertemente correlacionados con las personas que denuncian los correos que reciben como spam o abuso.
  • disposable - (do_not_mail) Estas direcciones de correo electrónico son temporales y pierden su validez tras un periodo determinado. Evite agregar correos desechables a su lista para evitar futuros rebotes.
  • role_based_catch_all - (do_not_mail) Estas direcciones están basadas en funciones y pertenecen a un dominio catch_all.
  • mx_forward - (do_not_mail) Estos correos electrónicos pertenecen a dominios configurados para reenviar sus registros MX hacia un único dominio. Su caso de uso es similar al de los dominios desechables.

  Direcciones de correo válidas e inválidas (validación omitida debido a altos riesgos):

  • global_suppression - (do_not_mail) Estos correos electrónicos se encuentran en muchas listas populares de eliminación global (GSL). Incluyen reclamantes conocidos de ISP, reclamantes directos, direcciones compradas, dominios que no envían correo y litigantes conocidos.
  • possible_trap - (do_not_mail) Estos correos electrónicos contienen palabras clave que podrían correlacionarse con posibles trampas de spam como spam@ o @spamtrap.com. Examínelos antes de decidir si enviar correos electrónicos o no.
  • toxic - (do_not_mail) Estas direcciones de correo electrónico son conocidas por abuso y spam. También pueden ser correos creados por bots. Si alguno de sus correos electrónicos tiene esta marca, no debe enviarle correos electrónicos. También proporcionamos campos adicionales que debe tener en cuenta antes de enviar un correo electrónico.
• unknown- No pudimos validarlo por una razón u otra. Los casos típicos incluyen un servidor de correo desconectado o un sistema de correo electrónico antispam.
  En la mayoría de los casos, el 80% de los desconocidos son direcciones de correo electrónico no válidas o incorrectas. Tenemos la menor cantidad de "desconocidos" de cualquier validador de correo electrónico y no hacemos esta afirmación con ligereza. Pagamos y probamos listas de correo electrónico en más de 50 empresas de validación para comparar resultados.
  Si encuentra un gran número de desconocidos, envíelos para su revalidación. Recuerde que no le cobraremos por resultados desconocidos, sino que le devolveremos los créditos. Si sigue teniendo un número elevado, comuníquese con nosotros, nos ocuparemos de verificarlos.
  • antispam_system - (unknown) Estos correos electrónicos tienen instalados sistemas antispam que nos impiden validarlos. Puede enviárnoslos a través de la pantalla de contacto.
  • exception_occurred - (unknown) Estos correos electrónicos provocaban una excepción al validarlos. Si esto ocurre repetidamente, avísenos.
  • failed_smtp_connection - (unknown) Estos correos pertenecen a un servidor de correo que no permite una conexión SMTP. La mayoría de las veces, estos correos electrónicos acaban siendo inválidos.
  • Desconexión_forzada - (unknown) 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 acaban siendo inválidos.
  • greylisted - (unknown) La tecnología de listas grises impide temporalmente el intento de validación. Si vuelve a enviar estos correos electrónicos, a menudo se validarán en una segunda pasada.
  • mail_server_did_not_respond - (unknown) Estos correos pertenecen a un servidor de correo que no responde a los comandos de correo. La mayoría de las veces, estos correos electrónicos acaban siendo inválidos.
  • mail_server_temporary_error - (unknown) Estos correos electrónicos pertenecen a un servidor de correo que devuelve un error temporal. La mayoría de las veces, estos correos electrónicos acaban siendo inválidos.
  • timeout_exceeded - (unknown) Estos correos electrónicos pertenecen a un servidor de correo que responde con lentitud. La mayoría de las veces, estos correos electrónicos acaban siendo inválidos.

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.

• free_email- [true/false] ¿El correo electrónico procede de un proveedor gratuito?
• mx_found- [true/false] ¿El dominio tiene un registro MX?
• mx_record- El registro MX preferido del dominio
• smtp_provider- El proveedor SMTP del correo electrónico o [null] (BETA)

Como servicio de validación de correo electrónico responsable, hacemos todo lo posible por proteger la reputación de su IP/dominio de correo. Su campaña por correo electrónico tiene éxito cuando su mensaje llega a la casilla de entrada y no a la de correo no deseado.

El estado "No enviar mensajes" representa uno de los siguientes pasos en los que identificamos correos electrónicos potenciales que pueden causar daños a su reputación de IP/dominio.

• MailChimp
• Constant_Contact
• SendGrid
• Nation_Builder
• Benchmark_Email
• Port_25

Profundicemos un poco más en el significado de basado en funciones y por qué, pero hagámoslo a partir de las exportaciones de correo de los principales proveedores de ESP que envían miles de millones de correos electrónicos a diario. Haga clic en los siguientes enlaces.

Hay cientos de enlaces más de varias empresas de mayor tamaño que las anteriores que explican por qué. Entendemos que, dependiendo de su modelo de negocio y de su sector, es posible que necesite enviar mensajes a correos electrónicos basados en funciones. Puede hacerlo, pero debemos comunicarle el riesgo que conlleva. La decisión sobre qué correos electrónicos basados en funciones enviar y si el riesgo merece la pena es suya.

Todos los correos electrónicos que marcamos como "Basados en funciones" son correos válidos.

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.