- Inicio
- Inicio rápido de validación de correo electrónico
INICIO RÁPIDO DE LA API
Versión 2: Primeros pasos
COLECCIÓN POSTMAN
Para probar la versión 2 de la API en Postman, guarde el contenido de la colección Postman como un archivo .json o puede obtener el archivo de nuestro repositorio de GitHub .
En Postman, en el menú superior, haga clic en Archivo y luego seleccione Importar. Luego elija el archivo JSON que guardó o descargó de GitHub para importarlo.
Archivo JSON de la Colección Postman:
La API de validación de correo electrónico de ZeroBounce funciona tanto en tiempo real como de forma masiva. Si necesita verificar los correos electrónicos de manera constante y desea ahorrar tiempo y automatizar el proceso, le recomendamos que utilice la función de volumen.
La API detecta más de 30 tipos de direcciones de correo electrónico riesgosas, evita que se incluyan en su lista y ayuda a mantener la higiene de su correo electrónico durante un período de tiempo más largo. Una lista de correo electrónico saludable respalda su reputación de remitente y es la piedra angular de una buena capacidad de entrega de correo electrónico.
Active la API hoy mismo instalándola en sus formularios de registro y suscripción, o dondequiera que recopile direcciones de correo electrónico en línea.
¿Necesita ayuda para comenzar con la API de validación de correo electrónico? Póngase en contacto con nuestro equipo de atención al cliente. Estamos aquí para responder a sus preguntas y ayudarle todo el día los 365 días del año.
Obtener saldo de crédito (v2)
Esta API le dirá cuántos créditos le quedan en su cuenta. Es simple, rápido y fácil de usar.
Aquí hay algunos escenarios en los que las empresas usarán esta API.
- Utiliza nuestra API para validar correos electrónicos y debe verificar dentro de un cierto marco de tiempo cuando su saldo de crédito es demasiado bajo, para poder realizar un pago.
- Quiere hacer un seguimiento de cuántos créditos de validación de correo electrónico está utilizando por su marco de tiempo definido para generar información estadística útil.
- Desea automatizar e integrar información en el panel de su aplicación que le muestre su saldo actual de crédito restante
A continuación, encontrará las instrucciones sobre cómo utilizar nuestra API. Es muy fácil de usar y requiere SSL.
OBTENER /V2/GETCREDITS
API URL: https://api.zerobounce.net/v2/getcredits
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.
URL Parameters
- ParámetrosDescripción
- api_keySu clave API, que se encuentra en su cuenta.
OBTENER MUESTRAS DE CÓDIGO DE SALDO DE CRÉDITO
Esta API le dirá cuántos créditos le quedan en su cuenta. Es simple, rápido y fácil de usar.
Si desea llamar a la API desde su navegador para probarlo, todo lo que tiene que hacer es reemplazar la CLAVE API con su clave:
https://api.zerobounce.net/v2/getcredits?api_key=[replacewithyours]
Esta API le dirá cuántos créditos le quedan en su cuenta.
La API devolverá estos resultados en formato JSON utilizando el método "getcredits" créditos: la cantidad de créditos que le quedan en su cuenta para las validaciones por correo electrónico. Si se devuelve un -1, eso significa que su clave de API no es válida.
RESPUESTA DEL PUNTO FINAL
Esta API le dirá cuántos créditos le quedan en su cuenta. Es simple, rápido y fácil de usar.
Respuesta exitosaGetCredits V1 y V2 Límites
Permitimos un máximo de 50.000 solicitudes en 1 hora para https://api.zerobounce.net/v1/getcredits y https://api.zerobounce.net/v2/getcredits antes de bloquear temporalmente durante 1 día.
Las solicitudes de claves incorrectas a https://api.zerobounce.net/v1/getcredits y https://api.zerobounce.net/v2/getcredits 200 veces en 1 hora resultarán en un bloqueo temporal por 1 día.
La versión 1 de la API de validación de correo electrónico ya no estará disponible en 1 de mayo de 2023. Realice los preparativos para actualizar a la versión 2 lo antes posible.
Cómo utilizar la API de ZeroBounce
Validar Correos Electrónicos (v1)
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ámetroDescripción
- emailLa dirección de correo electrónico que desea validar
- ipAddressLa dirección IP desde la que se registró el correo electrónico (puede estar en blanco, pero se requiere un parámetro)
- apiKeySu 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ámetroDescripción
- addressLa 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, trampa_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]
- 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 "@".
- 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.
- 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].
- creationdateLa fecha de creación del correo electrónico cuando esté disponible o [nulo] [Obsoleto].
- locationLa ubicación del propietario del correo electrónico cuando esté disponible o [nulo] [Obsoleto].
- processedatLa 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ámetroDescripción
- cityLa ciudad de la IP transmitida
- regionLa región / estado de la IP transmitida.
- zipcodeEl código postal de la IP transmitida.
- countryEl país de la PI transmitido.
VALIDAR MUESTRAS DE CÓDIGO DE CORREOS ELECTRÓNICOS
RESPUESTA DEL PUNTO FINAL
Respuesta exitosaValidació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.