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

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.
Parámetros URL
- ParámetroDescripción
- emailLa dirección de correo electrónico que quiere validar.
- ip_addressLa dirección IP desde la que se registró el correo (Puede estar en blanco o puede faltar por completo.)
- api_keySu clave API que se encuentra en su cuenta.
- tiempo de esperaLa duración (3 - 60 segundos) permitida para la validación. Si se cumple, la API devolverá desconocido/en lista gris. (parámetro opcional)
- activity_data[true/false] +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)
Aprende más sobre Verify+.
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:
Respuesta exitosa
{
"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",
"catchall_domain": false,
"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".
JSON Propiedades
- PropiedadesDescripción
- 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, accept_all, gold]
- 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_daysLa última fecha de actividad que es anterior a [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].
- catchall_domain[verdadero/falso o nulo] ¿El dominio es de tipo catch-all (el servidor de correo del dominio responde como válido a cualquier verificación SMTP y enviar un correo a una dirección inválida podría no rebotar)?
- 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/el estado de la IP transmitida o [nulo]
- zipcodeEl código postal de la IP transmitida o [nulo]
- countryEl país de la IP transmitida o [nulo]
- processed_atLa hora UTC en que se validó el correo electrónico.
Validación API V2 Límites
Permitimos un máximo de 80,000 solicitudes en 10 segundos validaciones (100,000 para los clientes de ZeroBounce ONE™) 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.