VALIDADOR DE CORREO ELECTRÓNICO POR LOTES - EN TIEMPO REAL (V2)

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: https://bulkapi.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.

Parámetros URL

Parámetro
Descripció
api_key
Su clave API
email_batch
[[Matriz de objetos], formato: {"dirección correo": "válido@ejemplo.com", "dirección_ip": "1.1.1.1"}
tiempo de espera
La duración (10 - 120 segundos) permitida para la validación. Si se cumple, la API devolverá desconocido/en lista gris. (parámetro opcional)

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}
          ]
  }

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

Respuesta exitosa


    {
      "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",
              "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",
              "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",
              "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.

Propiedades JSON

Propiedades
Descripció
email_batch
[Matriz] Una matriz de correos electrónicos validados
errors
[Matriz] Una matriz de errores incrustados, si los hay

Propiedades lote_correo

Propiedades
Descripció
address
La dirección de correo electrónico que está validando.
status
[valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail]
sub_status
[alternate, antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_trap, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address, role_based_catch_all, disposable, toxic]
account
La parte de la dirección de correo electrónico antes del símbolo "@".
domain
La parte de la dirección de correo electrónico después del símbolo "@".
did_you_mean
Solución sugerente para un error tipográfico en el correo electrónico
domain_age_days
Antigüedad del dominio de correo electrónico en días o [nulo].
free_email
[verdadero / falso] Si el correo electrónico proviene de un proveedor gratuito.
mx_found
[verdadero / falso] ¿El dominio tiene un registro MX?
mx_record
El registro MX preferido del dominio
smtp_provider
El proveedor SMTP del correo electrónico o [nulo] [BETA].
firstname
El nombre del propietario del correo electrónico cuando esté disponible o [nulo].
lastname
El apellido del propietario del correo electrónico cuando esté disponible o [nulo].
gender
El sexo del propietario del correo electrónico cuando esté disponible o [nulo].
city
La ciudad de la IP transmitida o [nulo]
region
La región / estado de la IP transmitida o [nulo]
zipcode
El código postal de la IP transmitida o [nulo]
country
El país de la PI transmitido o [nulo]
processed_at
La hora UTC en que se validó el correo electrónico.

Validación por lotes de BulkAPI y BulkAPI Límites

Permitimos un máximo de 250 solicitudes en 1 minuto para bulkapi.zerobounce.net/ antes de bloquear temporalmente durante 1 hora.

Permitimos un máximo de 20 solicitudes en 1 minuto para bulkapi.zerobounce.net/v2/validatebatch antes de bloquear temporalmente durante 10 minutos.

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

Las respuestas por lotes a bulkapi.zerobounce.net/v2/validate que contengan más de 20 estados desconocidos (que no estén en la lista gris ni sean antispam) más de una vez por hora se bloquearán temporalmente durante 1 hora.