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)
  • activity_data
    Si se establece en 'true', la información de los Datos de Actividad se añadirá al resultado de la validación.

Obtén más información sobre los Datos de Actividad.

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

  • 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].
  • active_in_days
    La fecha de la última actividad que es menor 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_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.