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",
"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].
- 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) 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.