DOCS

VALIDAR CORREOS ELECTRÓNICOS (V1)

Youtube video thumbnail

Cómo utilizar la API ZeroBounce

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. Este punto final se puede llamar de forma asincrónica y actualmente no tiene un límite de tráfico.

Para probar nuestra API sin usar créditos: por favor utilice los correos electrónicos que se proporcionan en nuestra documentación de Sandbox.

El tiempo de respuesta de nuestra API es de entre un segundo y 70 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 fuera de 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.

OBTENER/V1/VALIDATE

API URL: https://bulkapi.zerobounce.net/v1/validate

API URL (With GEO Append): https://bulkapi.zerobounce.net/v1/validatewithip

Parámetros URL

  • Parámetro
    Descripción
  • email
    La dirección de correo electrónico que desea validar
  • ip_address
    La dirección IP desde la que se registró el correo electrónico (puede estar en blanco, pero se requiere un parámetro)
  • api_key
    Su clave API, que se encuentra en su cuenta

Si desea llamar a la API desde su navegador para probarla, todo lo que necesita hacer es reemplazar la CLAVE API con su clave:

https://api.zerobounce.net/v1/validatewithip?apikey=replacewithyours&email=valid@example.com&ipAddress=156.124.12.145
o si no necesita GEO Append, simplemente llame al método de validación.

https://api.zerobounce.net/v1/validate?apikey=replacewithyours&email=valid@example.com

La API devolverá estos resultados en formato JSON mediante el método "validar".

  • Parámetro
    Descripción
  • address
    La dirección de correo electrónico que está validando.
  • status
    [válido, inválido, general, desconocido, trampa de spam, abuso, no_envia_correo
  • sub_status
    [sistema_antispam, enlalistagris, error_temporario_servidor de correo, desconexión_forzosa, servidor_correo_no_repondió, tiempo de espera_excedido, conexión_smtp_fallida, cuota_de buzón_excedido, excepción_ocurrida, trampas_posibles, basado en roles, supresión_global, buzón_no_encontrado, sin_entradas_dns, comprobación_de_sintaxis_fallida, posible_error tipografico, dirección_ip_no enrutable, período_principal_eliminado, no_acepta_correo, dirección_alias]
  • 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 "@".
  • disposable
    [verdadero, falso] Se sabe que estas direcciones de correo electrónico son abusivas, spam o creadas por bot.
  • toxic
    [verdadero, falso] Se sabe que estas direcciones de correo electrónico son abusivas, spam o creadas por bot.
  • 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].
  • creationdate
    La fecha de creación del correo electrónico cuando esté disponible o [nulo] [Obsoleto].
  • location
    La ubicación del propietario del correo electrónico cuando esté disponible o [nulo] [Obsoleto].
  • processedat
    La hora UTC en que se validó el correo electrónico.

La API devolverá estos campos adicionales utilizando "validatewithip" devolverá estos campos adicionales utilizando el método validatewithip:

  • Parámetro
    Descripción
  • city
    La ciudad de la IP transmitida
  • region
    La región / estado de la IP transmitida.
  • zipcode
    El código postal de la IP transmitida.
  • country
    El país de la PI transmitido.

VALIDAR MUESTRAS DE CÓDIGO DE CORREOS ELECTRÓNICOS

RESPUESTA DEL PUNTO FINAL

Respuesta exitosa
Respuesta exitosa con IP
Respuesta de error

Validación API V1 y V2 Límites

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

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