Contenedores API

Java

/zerobounce-api-wrappers/v2-java/

Puede encontrar el Contenedor oficial de Java API v2 ZeroBounce:

SDK oficial de JAVA:

Este es un ejemplo de clase java wrapper para ZeroBounce API v2.

El proyecto tiene 2 dependencias:

  • Cliente http apache
  • Json (org.json)

Descargue las dependencias por separado y agréguelas a la ruta correspondiente o agregue las siguientes dependencias a su archivo pom.xml si está compilando a través de Maven (ya agregado si está clonando este repositorio):

Método de validación (correo electrónico):

  • Propiedades
    Valores posibles
  • getEmailAddress ()
    La dirección de correo electrónico que está validando.
  • obtener el estado()
    Válido
    inválido
    Atrapar todo
    desconocido
    trampa de spam
    abuso
    Donotmail
  • getSubStatus ()
    sistema antispam
    en la lista gris
    mail_server_temporary_error
    desconexión forzada
    mail_server_did_not_respond
    timeout_exceeded
    failure_smtp_connection
    ha superado la cuota de buzón
    ocurrió una excepción
    trampas posibles
    basado en roles
    global_suppression
    buzón_no_encontrado
    no_dns_entries
    fail_syntax_check
    possible_typo
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    dirección_alias
    role_based_catch_all
  • getAccount ()
    La parte de la dirección de correo electrónico antes del símbolo "@".
  • getDomain ()
    La parte de la dirección de correo electrónico despus del símbolo "@".
  • getDidYouMean ()
    Solución sugerente para un error tipográfico de correo electrónico o [nulo]
  • getDomainAgeDays ()
    Antigüedad del dominio de correo electrónico en días o [nulo].
  • isFreeEmail ()
    [verdadero / falso] Si el correo electrónico proviene de un proveedor gratuito.
  • isMXFound ()
    [verdadero / falso] ¿El dominio tiene un registro MX?
  • getMXRecord ()
    El registro MX preferido del dominio o [nulo].
  • getSMTPProvider ()
    El proveedor SMTP del correo electrónico o [nulo] (BETA).
  • getFirstName ()
    El primer nombre del propietario del correo electrónico cuando esté disponible o [nulo].
  • getLastName ()
    El apellido del propietario del correo electrónico cuando esté disponible o [nulo].
  • getGender ()
    El género del propietario del correo electrónico cuando está disponible o [nulo].
  • getCountry ()
    El país de donde proviene la dirección IP.
  • getCity ()
    La ciudad de donde proviene la dirección IP.
  • getZipcode ()
    El código postal de donde proviene la dirección IP.
  • getRegion ()
    La región / estado de donde proviene la dirección IP.
  • getProcessedAt ()
    La hora UTC en que se validó el correo electrónico.

Método getCredit ()

  • Propiedades
    Valores posibles
  • obtener créditos()
    El número de créditos restantes en la cuenta para la validación del correo electrónico.

  // Dependiendo de cómo use la API, es posible que desee que se agote el tiempo más rápido,
  // por ejemplo en una pantalla de registro. 
  // Normalmente, la API devolverá resultados muy rápido, pero un pequeño porcentaje de
  // los servidores de correo tardan más de 20 + segundos en responder. 
  // Si la API agota el tiempo de espera, devolverá un estado de "Desconocido" y 
  // un sub_estado de "timeout_exceeded"  

  Zerobounceapi zeroBounceApi = NUEVO Zerobounceapi("YOUR_API_KEY",TIMEOUT_IN_SECONDS);

  // Obtenga créditos y asigne a la variable int
  en t credits = zeroBounceApi.obtener créditos();

  // valida el correo electrónico y asigna el resultado a un objeto ZeroBounceResponse

  Respuesta cero validation = zeroBounceApi.validar("some@email.com", "alguna.ip.dirección puede estar en blanco");
  validation.getemailaddress();
  validation.obtener el estado();
  validation.es desechable();
  validation.getcountry();
      

Javascript

/zerobounce-api-wrappers/v2-javascript/

Puede encontrar la API de JavaScript ZeroBounce v2 a continuación:

Los validar y obtener créditos Los métodos devuelven objetos de los que puede recuperar fácilmente las propiedades de las propiedades a continuación.

Propiedades y posibles valores devueltos por los métodos:

validar método

  • PROPIEDAD
    Valores posibles
  • habla a
    La dirección de correo electrónico que está validando.
  • estado
    Válido
    inválido
    Atrapar todo
    desconocido
    trampa de spam
    abuso
    do_not_mail
  • sub_status
    sistema antispam
    en la lista gris
    mail_server_temporary_error
    desconexión forzada
    mail_server_did_not_respond
    timeout_exceeded
    failure_smtp_connection
    ha superado la cuota de buzón
    ocurrió una excepción
    trampas posibles
    basado en roles
    global_suppression
    buzón_no_encontrado
    no_dns_entries
    fail_syntax_check
    possible_typo
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    dirección_alias
    tóxico
    desechable
    role_based_catch_all
  • cuenta
    La parte de la dirección de correo electrónico antes del símbolo "@".
  • Dominio
    La parte de la dirección de correo electrónico despus del símbolo "@".
  • querías decir
    Solución sugerente para un error tipográfico de correo electrónico o [nulo]
  • domain_age_days
    Antigüedad del dominio de correo electrónico en días o [nulo]
  • correo electrónico gratuito
    [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 o [nulo]
  • smtp_provider
    El proveedor de SMTP del correo electrónico o [nulo] (BETA)
  • apellido
    El apellido del propietario del correo electrónico cuando esté disponible o [nulo]
  • género
    El género del propietario del correo electrónico cuando está disponible o [nulo]
  • país
    El país de donde proviene la dirección IP
  • región
    El estado / región de donde proviene la dirección IP
  • ciudad
    La ciudad de donde es la dirección IP
  • código postal
    El código postal de donde proviene la dirección IP
  • procesado en
    La hora UTC en que se validó el correo electrónico

Método GetCredit

  • PROPIEDAD
    Valores posibles
  • créditos
    El número de créditos restantes en la cuenta para la validación del correo electrónico.

  var Zerobounceapi = NUEVO Zerobounceapi(apiKey)
  Zerobounceapi.Clave API
  Zerobounceapi.obtener créditos()
  Zerobounceapi.validar("some@email.com", "alguna.ip.dirección puede estar en blanco")
      

Pitón

/zerobounce-api-wrappers/v2-python/

Puede encontrar el envoltorio oficial de ZeroBounce Python API v2 a continuación:

Puede encontrar el SDK de ZeroBounce Python a continuación:

Ejemplo de uso

Los validar y obtener credito Los métodos devuelven objetos de los que puede recuperar fácilmente las propiedades de las propiedades a continuación.

Propiedades y posibles valores devueltos por los métodos:

validar método

  • PROPIEDAD
    Valores posibles
  • habla a
    La dirección de correo electrónico que está validando.
  • estado
    Válido
    inválido
    Atrapar todo
    desconocido
    trampa de spam
    abuso
    do_not_mail
  • sub_status
    sistema antispam
    en la lista gris
    mail_server_temporary_error
    desconexión forzada
    mail_server_did_not_respond
    timeout_exceeded
    failure_smtp_connection
    ha superado la cuota de buzón
    ocurrió una excepción
    trampas posibles
    basado en roles
    global_suppression
    buzón_no_encontrado
    no_dns_entries
    fail_syntax_check
    possible_typo
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    dirección_alias
    tóxico
    desechable
    role_based_catch_all
  • cuenta
    La parte de la dirección de correo electrónico antes del símbolo "@".
  • Dominio
    La parte de la dirección de correo electrónico despus del símbolo "@".
  • querías decir
    Solución sugerente para un error tipográfico de correo electrónico o [nulo]
  • domain_age_days
    Antigüedad del dominio de correo electrónico en días o [nulo]
  • correo electrónico gratuito
    [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 o [nulo]
  • smtp_provider
    El proveedor de SMTP del correo electrónico o [nulo] (BETA)
  • apellido
    El apellido del propietario del correo electrónico cuando esté disponible o [nulo]
  • género
    El género del propietario del correo electrónico cuando está disponible o [nulo]
  • país
    El país de donde proviene la dirección IP
  • región
    El estado / región de donde proviene la dirección IP
  • ciudad
    La ciudad de donde es la dirección IP
  • código postal
    El código postal de donde proviene la dirección IP
  • procesado en
    La hora UTC en que se validó el correo electrónico

Método GetCredit

  • PROPIEDAD
    Valores posibles
  • créditos
    El número de créditos restantes en la cuenta para la validación del correo electrónico.

  desde zerobounce importar ZeroBounceAPI

  zba = ZeroBounceAPI('yourapikey____________')
  impresión zba.get_credits()
  resp1 = zba.validate('flowerjill@aol.com','123.145.124.12')
  
  impresión resp1
  {
  "habla a":"flowerjill@aol.com",
  "estado":"válido",
  "sub_status":"",
  "correo electrónico gratuito":Cierto,
  "querías decir":Ninguna,
  "cuenta":"flowerjill",
  "dominio":"aol.com",
  "domain_age_days": "8426",
  "smtp_provider":"yahoo",
  "mx_record":"mx-aol.mail.gm0.yahoodns.net",
  "mx_found": "cierto",
  "primer nombre":"jill",
  "apellido":"stein",
  "género":"hembra",
  "país":"Estados Unidos",
  "región":"Florida",
  "ciudad":"West Palm Beach",
  "código postal":"33401",
  "procesado en":"2017-04-01 02:48:02.592"
  }
  
  impresión resp.firstname
  Jill
  
  impresión resp2.status
  valid
      
      

PHP

/zerobounce-api-wrappers/v2-php/

Contenedor oficial de ZeroBounce API v2:

SDK oficial de PHP:Bibliotecas contribuidas por el usuario:

Este es un ejemplo de clase de contenedor PHP para la API ZeroBounce.

Ejemplo de uso:

Los métodos de validación devuelven objetos a los que llama métodos get que devuelven la información relevante. Vea el código de muestra a la derecha:

Los validar y obtener créditos Los métodos devuelven objetos de los que puede recuperar fácilmente las propiedades de las propiedades a continuación.

Propiedades y posibles valores devueltos por los métodos:

validar método

  • PROPIEDAD
    Valores posibles
  • habla a
    La dirección de correo electrónico que está validando.
  • estado
    Válido
    inválido
    Atrapar todo
    desconocido
    trampa de spam
    abuso
    do_not_mail
  • sub_status
    sistema antispam
    en la lista gris
    mail_server_temporary_error
    desconexión forzada
    mail_server_did_not_respond
    timeout_exceeded
    failure_smtp_connection
    ha superado la cuota de buzón
    ocurrió una excepción
    trampas posibles
    basado en roles
    global_suppression
    buzón_no_encontrado
    no_dns_entries
    fail_syntax_check
    possible_typo
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    dirección_alias
    tóxico
    desechable
    role_based_catch_all
  • cuenta
    La parte de la dirección de correo electrónico antes del símbolo "@".
  • Dominio
    La parte de la dirección de correo electrónico despus del símbolo "@".
  • querías decir
    Solución sugerente para un error tipográfico de correo electrónico o [nulo]
  • domain_age_days
    Antigüedad del dominio de correo electrónico en días o [nulo]
  • correo electrónico gratuito
    [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 o [nulo]
  • smtp_provider
    El proveedor de SMTP del correo electrónico o [nulo] (BETA)
  • apellido
    El apellido del propietario del correo electrónico cuando esté disponible o [nulo]
  • género
    El género del propietario del correo electrónico cuando está disponible o [nulo]
  • país
    El país de donde proviene la dirección IP
  • región
    El estado / región de donde proviene la dirección IP
  • ciudad
    La ciudad de donde es la dirección IP
  • código postal
    El código postal de donde proviene la dirección IP
  • procesado en
    La hora UTC en que se validó el correo electrónico

Método GetCredit

  • PROPIEDAD
    Valores posibles
  • créditos
    El número de créditos restantes en la cuenta para la validación del correo electrónico.

  <?php
  requerir una vez("zerobounce.php");
  
  $ zba = NUEVO Zerobounceapi('YOUR_API_KEY');
  
  // imprime el saldo acreedor
  print_r($ zba->obtener créditos());
  
  // instanciar un objeto de validación después de una llamada a 
  // validar e imprimir elementos individuales
  validación de $ = $ zba->validar('email@address.com', 'IP puede estar en blanco');
  eco validación de $['habla a'];
  eco validación de $['estado'];
  print_r($ zba->validar('email@address.com', 'IP'));
  ?>
      

PHP 7

/zerobounce-api-wrappers/v2-php7/

Puede encontrar este contenedor PHP7 contribuido por el usuario a continuación:

Prerrequisitos Necesita una cuenta activa en https://zerobounce.net para usar esta biblioteca. Desde allí, tome su clave API en API - Claves e información.

Instalación Para incluir esto en su proyecto, instálelo usando Composer.

Como usamos tipos de retorno y sugerencias de tipo, esta biblioteca requiere PHP 7.1.

compositor requiere nickdnk / zerobounce-php

Pruebas Ingrese su clave API en el archivo ZeroBounceTest y ejecútelo. Esto utiliza los correos electrónicos de prueba suministrados por ZeroBounce y no le costará crédito.


  utilizar nickdnkzerobounceemail;
  utilizar nickdnkzerobounceresult;
  utilizar nickdnkzerobouncezerobounce;
  
  // Puedes modificar el tiempo de espera usando el segundo parámetro. El valor predeterminado es 15.
  $ handler = NUEVO Cero rebote('my_api_key', 30);
  
  $ email = NUEVO CORREO ELECTRÓNICO(
  
      // La dirección de correo electrónico que quieres consultar
      'some-email@domain.com',
  
      // y si lo tiene, la dirección IP, de lo contrario es nula u omitida
      '123.123.123.123'
  
  );
  
  Tratar {
  
      // Validar el correo electrónico
      $ resultado = $ handler->validar correo electrónico($ email);
  
      Si ($ resultado->obtener el estado() === RESULTADO::ESTADO_VÁLIDO) {
  
          // Todo bien
  
          Si ($ resultado->isfreeemail()) {
  
              // La dirección de correo electrónico es gratuita, como @ gmail.com, @ hotmail.com.
  
          }
  
          / ** * El objeto de usuario contiene metadatos sobre la dirección de correo electrónico * proporcionada por ZeroBounce. Todos estos pueden ser cadenas nulas o vacías *, así que recuerde verificar eso. * /
          $ usuario = $ resultado->getuser();
  
          $ usuario->getcountry();
          $ usuario->getregion();
          $ usuario->getzipcode();
          $ usuario->getcity();
          $ usuario->getgender();
          $ usuario->getfirstname();
          $ usuario->getlastname();
  
      } más Si ($ resultado->obtener el estado() === RESULTADO::STATUS_DO_NOT_MAIL) {
  
          // El código de fondo te ayudará a determinar el problema exacto:
  
          cambiar ($ resultado->getsubstatus()) {
  
              caso RESULTADO::SUBSTATUS_DISPOSABLE:
              caso RESULTADO::SUBSTATUS_TOXIC:
                  // Tóxico o desechable.
                  rotura;
  
  
              caso RESULTADO::SUBSTATUS_ROLE_BASED:
                  // admin @, helpdesk @, info @ etc; no un correo electrónico personal
                  rotura;
  
              // ... y así.
  
          }
  
      } más Si ($ resultado->obtener el estado() === RESULTADO::ESTADO_INVÁLIDO) {
  
          // Email inválido.
  
      } más Si ($ resultado->obtener el estado() === RESULTADO::STATUS_SPAMTRAP) {
  
          // Trampa de spam.
  
      } más Si ($ resultado->obtener el estado() === RESULTADO::ESTADO_ABUSO) {
  
          // Abuso.
  
      } más Si ($ resultado->obtener el estado() === RESULTADO::STATUS_CATCH_ALL) {
  
          // La dirección es catch-all; no necesariamente un correo electrónico privado.
  
      } más Si ($ resultado->obtener el estado() === RESULTADO::ESTADO DESCONOCIDO) {
  
          // Estado de correo electrónico desconocido.
  
      }
  
      / * * Para saber cómo usar y reaccionar a diferentes códigos de estado y * estado, consulte la documentación de ZeroBounce en: * https://www.zerobounce.net/docs/?swift#version-2__v2__ * /
  
  } Captura (
ickdnkZeroBounceAPIError $ excepción) {
  
    // Algo pasó. Quizás una clave API incorrecta o crédito insuficiente.
  
  }