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

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 un resultado desconocido. Este punto final se puede llamar de forma asincrónica y actualmente no tiene una limitación de tráfico.

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 es de entre un segundo y 30 segundos. Dado que las API están destinadas a ser rápidas por naturaleza, limitamos la cantidad de tiempo que dedicamos a validar una dirección de correo electrónico. Así que si encontramos un servidor de correo lento o un servidor de correo con un algoritmo de greylisting, obtendrá un resultado desconocido. Siempre puede volver a validar esas condiciones, cargando un archivo al validador de correo electrónico masivo..

En promedio, el 96-98% de todos los dominios regresará en 1 a 5 segundos, hay un puñado de dominios que se ejecutan desde Postfix / Dovecot que tienen un tiempo de conexión de 20 segundos para validaciones en tiempo real y un porcentaje fraccional muy pequeño de otros dominios que son muy lentos para responder a las consultas de SMTP. Todos los principales ISP volverán en 1 a 3 segundos, que suele ser la mayor parte de la distribución de correo electrónico.

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

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 un resultado desconocido. Este punto final se puede llamar de forma asincrónica y actualmente no tiene una limitación de tráfico.

*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ámetro
    Descripción
  • email
    La dirección de correo electrónico que quiere validar.
  • ip_address
    La dirección IP desde la que se registró el correo (Puede estar en blanco, pero se requiere un parámetro)
  • api_key
    Su clave API que se encuentra en su cuenta.
  • tiempo de espera
    La duración (3 - 60 segundos) permitida para la validación. Si se cumple, la API devolverá desconocido/en lista gris. (parámetro opcional)
Si desea llamar a la API desde su navegador para probarlo, todo lo que necesita hacer es reemplazar la CLAVE API con su 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

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

  • Propiedades
    Descripción
  • 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/el estado de la IP transmitida o [nulo]
  • zipcode
    El código postal de la IP transmitida o [nulo]
  • country
    El país de la IP transmitida o [nulo]
  • processed_at
    La hora UTC en que se validó el correo electrónico.

Validación API V2 Límites

Permitimos un máximo de 50.000 solicitudes en 10 segundos (validaciones) para https://api.zerobounce.net/v2/validate y https://api-us.zerobounce.net/v2/validate* antes de bloquear temporalmente durante 1 minuto.

Las solicitudes de claves incorrectas a https://api.zerobounce.net/v2/validate y https://api-us.zerobounce.net/v2/validate*200 veces en 1 hora darán como resultado un bloqueo temporal de 1 hora.

*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.