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:
- 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.
Parámetros URL
- ParámetroDescripció
- api_keySu clave API
- email_batch[[Matriz de objetos], formato: {"dirección correo": "válido@ejemplo.com", "dirección_ip": "1.1.1.1"}
- tiempo de esperaLa duración (10 - 120 segundos) permitida para la validación. Si se cumple, la API devolverá desconocido/en lista gris. (parámetro opcional)
- activity_data[true/false] Si se establece en ‘true’, la información de Activity Data se añadirá al resultado de la validación. (parámetro opcional)
Más información sobre Activity Data. - verify_plus[true/false] Si se establece en ‘true’, se utilizará el método de validación Verify+ para obtener el resultado de la validación. Esto anula la configuración de la cuenta con respecto a Verify+. (parámetro opcional)
Más información sobre Verify+.
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:
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",
"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.
Propiedades JSON
- PropiedadesDescripció
- email_batch[Matriz] Una matriz de correos electrónicos validados
- errors[Matriz] Una matriz de errores incrustados, si los hay
Propiedades lote_correo
- PropiedadesDescripció
- addressLa 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]
- accountLa parte de la dirección de correo electrónico antes del símbolo "@".
- domainLa parte de la dirección de correo electrónico después del símbolo "@".
- did_you_meanSolución sugerente para un error tipográfico en el correo electrónico
- domain_age_daysAntigüedad del dominio de correo electrónico en días o [nulo].
- active_in_daysFecha de última actividad menor que [30/60/90/180/365/365+]
- 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_recordEl registro MX preferido del dominio
- smtp_providerEl proveedor SMTP del correo electrónico o [nulo] [BETA].
- firstnameEl nombre del propietario del correo electrónico cuando esté disponible o [nulo].
- lastnameEl apellido del propietario del correo electrónico cuando esté disponible o [nulo].
- genderEl sexo del propietario del correo electrónico cuando esté disponible o [nulo].
- cityLa ciudad de la IP transmitida o [nulo]
- regionLa región / estado de la IP transmitida o [nulo]
- zipcodeEl código postal de la IP transmitida o [nulo]
- countryEl país de la PI transmitido o [nulo]
- processed_atLa hora UTC en que se validó el correo electrónico.