Wrapper API

Giava

/ zerobounce-api-wrappers / v2-java /

Puoi trovare il wrapper ufficiale ZeroBounce Java API v2:

SDK ufficiale JAVA:

Questo è un esempio di classe wrapper java per ZeroBounce API v2.

Il progetto ha 2 dipendenze:

  • Apache httpclient
  • Json (org.json)

Scarica le dipendenze separatamente e aggiungile al percorso pertinente o aggiungi le seguenti dipendenze al tuo file pom.xml se stai compilando tramite Maven (già aggiunto se stai clonando questo repository):

Convalida metodo (e-mail):

  • Proprietà
    Valori possibili
  • getEmailAddress ()
    L'indirizzo email che stai convalidando.
  • getStatus ()
    Valido
    non valido
    Catch-all
    sconosciuto
    spamtrap
    abuso
    Donotmail
  • getSubStatus ()
    antispam_system
    greylist
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    quota mailbox superata
    exception_occurred
    possible_traps
    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
  • getAccount ()
    La parte dell'indirizzo e-mail prima del simbolo "@".
  • getDomain ()
    La parte dell'indirizzo e-mail dopo il simbolo "@".
  • getDidYouMean ()
    Correzione suggestiva per un errore di battitura o [null]
  • getDomainAgeDays ()
    Età del dominio di posta elettronica in giorni o [null].
  • isFreeEmail ()
    [vero / falso] Se l'email proviene da un provider gratuito.
  • isMXFound ()
    [true / false] Il dominio ha un record MX.
  • getMXRecord ()
    Il record MX preferito del dominio o [null].
  • getSMTPProvider ()
    Il provider SMTP dell'email o [null] (BETA).
  • getFirstName ()
    Il nome del proprietario dell'email se disponibile o [null].
  • getLastName ()
    Il cognome del proprietario dell'email se disponibile o [null].
  • getGender ()
    Il sesso del proprietario dell'email se disponibile o [null].
  • getCountry ()
    Il paese da cui proviene l'indirizzo IP.
  • getCity ()
    La città da cui proviene l'indirizzo IP.
  • getZipcode ()
    Il codice postale da cui proviene l'indirizzo IP.
  • getRegion ()
    La regione / stato da cui proviene l'indirizzo IP.
  • getProcessedAt ()
    L'ora UTC in cui è stata convalidata l'email.

getCredit () metodo

  • Proprietà
    Valori possibili
  • getCredits ()
    Il numero di crediti rimasti nell'account per la convalida dell'email

  // A seconda di come usi l'API, potresti desiderare che scada più rapidamente,
  // ad esempio su una schermata di registrazione. 
  // Normalmente l'API restituirà risultati molto velocemente, ma una piccola percentuale di
  // i server di posta impiegano fino a 20 + secondi per rispondere. 
  // Se l'API scade, restituirà lo stato "Sconosciuto" e 
  // un sub_status di "timeout_exceeded"  

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

  // Ottieni crediti e assegna alla variabile int
  int credits = zeroBounceApi.getcredits();

  // convalida l'e-mail e assegna il risultato a un oggetto ZeroBounceResponse

  Zerobounceresponse validation = zeroBounceApi.convalidare("some@email.com", "some.ip.address può essere vuoto");
  validation.getemailaddress();
  validation.getStatus();
  validation.isdisposable();
  validation.getcountry();
      

Script Java

/ zerobounce-api-wrappers / v2-javascript /

Puoi trovare l'API JavaScript ZeroBounce v2 di seguito:

Il convalidare e getCredits i metodi restituiscono oggetti da cui è possibile recuperare facilmente le proprietà seguenti.

Proprietà e possibili valori restituiti dai metodi:

metodo di validazione

  • Proprietà
    Valori possibili
  • indirizzo
    L'indirizzo email che stai convalidando.
  • stato
    Valido
    non valido
    Catch-all
    sconosciuto
    spamtrap
    abuso
    do_not_mail
  • sub_status
    antispam_system
    greylist
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    quota mailbox superata
    exception_occurred
    possible_traps
    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
    tossico
    monouso
    role_based_catch_all
  • account
    La parte dell'indirizzo e-mail prima del simbolo "@".
  • Dominio
    La parte dell'indirizzo e-mail dopo il simbolo "@".
  • intendevi
    Correzione suggestiva per un errore di battitura o [null]
  • domain_age_days
    Età del dominio e-mail in giorni o [null]
  • free_email
    [vero / falso] Se l'e-mail proviene da un provider gratuito
  • mx_found
    [true / false] Il dominio ha un record MX
  • mx_record
    Il record MX preferito del dominio o [null]
  • smtp_provider
    Il provider SMTP dell'email o [null] (BETA)
  • cognome
    Il cognome del proprietario dell'e-mail quando disponibile o [null]
  • genere
    Il genere del proprietario dell'email quando disponibile o [null]
  • nazione
    Il paese da cui proviene l'indirizzo IP
  • regione
    Lo stato / regione da cui proviene l'indirizzo IP
  • città
    La città da cui proviene l'indirizzo IP
  • cap
    Il codice postale da cui proviene l'indirizzo IP
  • processed_at
    L'ora UTC in cui l'e-mail è stata convalidata

Metodo GetCredit

  • Proprietà
    Valori possibili
  • titoli di coda
    Il numero di crediti rimasti nell'account per la convalida dell'email.

  var Zerobounceapi = Nuovo Zerobounceapi(apiKey)
  Zerobounceapi.Chiave API
  Zerobounceapi.getcredits()
  Zerobounceapi.convalidare("some@email.com", "some.ip.address può essere vuoto")
      

Pitone

/ zerobounce-api-wrappers / v2-python /

Di seguito puoi trovare il wrapper ufficiale ZeroBounce Python API v2:

Di seguito puoi trovare ZeroBounce Python SDK:

Utilizzo di esempio

Il convalidare e get_credit i metodi restituiscono oggetti da cui è possibile recuperare facilmente le proprietà seguenti.

Proprietà e possibili valori restituiti dai metodi:

metodo di validazione

  • Proprietà
    Valori possibili
  • indirizzo
    L'indirizzo email che stai convalidando.
  • stato
    Valido
    non valido
    Catch-all
    sconosciuto
    spamtrap
    abuso
    do_not_mail
  • sub_status
    antispam_system
    greylist
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    quota mailbox superata
    exception_occurred
    possible_traps
    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
    tossico
    monouso
    role_based_catch_all
  • account
    La parte dell'indirizzo e-mail prima del simbolo "@".
  • Dominio
    La parte dell'indirizzo e-mail dopo il simbolo "@".
  • intendevi
    Correzione suggestiva per un errore di battitura o [null]
  • domain_age_days
    Età del dominio e-mail in giorni o [null]
  • free_email
    [vero / falso] Se l'e-mail proviene da un provider gratuito
  • mx_found
    [true / false] Il dominio ha un record MX
  • mx_record
    Il record MX preferito del dominio o [null]
  • smtp_provider
    Il provider SMTP dell'email o [null] (BETA)
  • cognome
    Il cognome del proprietario dell'e-mail quando disponibile o [null]
  • genere
    Il genere del proprietario dell'email quando disponibile o [null]
  • nazione
    Il paese da cui proviene l'indirizzo IP
  • regione
    Lo stato / regione da cui proviene l'indirizzo IP
  • città
    La città da cui proviene l'indirizzo IP
  • cap
    Il codice postale da cui proviene l'indirizzo IP
  • processed_at
    L'ora UTC in cui l'e-mail è stata convalidata

Metodo GetCredit

  • Proprietà
    Valori possibili
  • titoli di coda
    Il numero di crediti rimasti nell'account per la convalida dell'email.

  a partire dal zerobounce importare ZeroBounceAPI

  zba = ZeroBounceAPI("yourapikey____________")
  stampare zba.get_credits()
  resp1 = zba.validate('flowerjill@aol.com','123.145.124.12')
  
  stampare resp1
  {
  "indirizzo":"flowerjill@aol.com",
  "stato":"valido",
  "sub_status":"",
  "free_email":Vero,
  "intendevi":Nessuna,
  "account":"flowerjill",
  "dominio":"aol.com",
  "domain_age_days": "8426",
  "smtp_provider":"yahoo",
  "mx_record":"mx-aol.mail.gm0.yahoodns.net",
  "mx_found": "vero",
  "nome di battesimo":"jill",
  "cognome":"boccale",
  "genere":"femmina",
  "nazione":"Stati Uniti",
  "regione":"Florida",
  "città":"west palm beach",
  "cap":"33401",
  "processed_at":"2017-04-01 02:48:02.592"
  }
  
  stampare resp.firstname
  Jill
  
  stampare resp2.status
  valid
      
      

PHP

/ zerobounce-api-wrappers / v2-php /

Wrapper API ZeroBounce ufficiale v2:

SDK PHP ufficiale:Librerie fornite dall'utente:

Questo è un esempio di classe wrapper PHP per l'API ZeroBounce.

Esempio di utilizzo:

I metodi di convalida restituiscono gli oggetti su cui si chiama ottengono metodi che restituiscono le informazioni pertinenti. Si prega di consultare il codice di esempio sulla destra:

Il convalidare e getCredits i metodi restituiscono oggetti da cui è possibile recuperare facilmente le proprietà seguenti.

Proprietà e possibili valori restituiti dai metodi:

metodo di validazione

  • Proprietà
    Valori possibili
  • indirizzo
    L'indirizzo email che stai convalidando.
  • stato
    Valido
    non valido
    Catch-all
    sconosciuto
    spamtrap
    abuso
    do_not_mail
  • sub_status
    antispam_system
    greylist
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    quota mailbox superata
    exception_occurred
    possible_traps
    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
    tossico
    monouso
    role_based_catch_all
  • account
    La parte dell'indirizzo e-mail prima del simbolo "@".
  • Dominio
    La parte dell'indirizzo e-mail dopo il simbolo "@".
  • intendevi
    Correzione suggestiva per un errore di battitura o [null]
  • domain_age_days
    Età del dominio e-mail in giorni o [null]
  • free_email
    [vero / falso] Se l'e-mail proviene da un provider gratuito
  • mx_found
    [true / false] Il dominio ha un record MX
  • mx_record
    Il record MX preferito del dominio o [null]
  • smtp_provider
    Il provider SMTP dell'email o [null] (BETA)
  • cognome
    Il cognome del proprietario dell'e-mail quando disponibile o [null]
  • genere
    Il genere del proprietario dell'email quando disponibile o [null]
  • nazione
    Il paese da cui proviene l'indirizzo IP
  • regione
    Lo stato / regione da cui proviene l'indirizzo IP
  • città
    La città da cui proviene l'indirizzo IP
  • cap
    Il codice postale da cui proviene l'indirizzo IP
  • processed_at
    L'ora UTC in cui l'e-mail è stata convalidata

Metodo GetCredit

  • Proprietà
    Valori possibili
  • titoli di coda
    Il numero di crediti rimasti nell'account per la convalida dell'email.

  <?php
  require_once("zerobounce.php");
  
  $ zba = Nuovo Zerobounceapi('YOUR_API_KEY');
  
  // stampa il saldo del credito
  print_r($ zba->get_credits());
  
  // crea un'istanza di un oggetto di convalida dopo una chiamata a 
  // convalida e stampa i singoli elementi
  $ convalida = $ zba->convalidare('email@address.com', 'IP può essere vuoto');
  eco $ convalida['indirizzo'];
  eco $ convalida['stato'];
  print_r($ zba->convalidare('email@address.com', 'IP'));
  ?>
      

PHP 7

/ zerobounce-api-wrappers / v2-php7 /

È possibile trovare questo wrapper PHP7 con contributo dell'utente qui sotto:

Prerequisiti È necessario un account attivo su https://zerobounce.net per utilizzare questa libreria. Da lì, prendi la tua chiave API in API - Chiavi e informazioni.

Installazione Per includerlo nel tuo progetto, installalo usando Composer.

Poiché utilizziamo i tipi restituiti e i suggerimenti sul tipo, questa libreria richiede PHP 7.1.

il compositore richiede nickdnk / zerobounce-php

test Immettere la chiave API nel file ZeroBounceTest ed eseguirla. Questo utilizza le e-mail di prova fornite da ZeroBounce e non ti costerà credito.


  uso nickdnkzerobounceemail;
  uso nickdnkzerobounceresult;
  uso nickdnkzerobouncezerobounce;
  
  // È possibile modificare il timeout utilizzando il secondo parametro. L'impostazione predefinita è 15.
  $ gestore = Nuovo Zerobounce('my_api_key', 30);
  
  $ e-mail = Nuovo E-MAIL(
  
      // L'indirizzo e-mail che si desidera controllare
      'some-email@domain.com',
  
      // e se ce l'hai, l'indirizzo IP - altrimenti nullo o omesso
      '123.123.123.123'
  
  );
  
  PROVARE {
  
      // Convalida l'e-mail
      $ risultato = $ gestore->validateEmail($ e-mail);
  
      Se ($ risultato->getStatus() === Risultato::STATUS_VALID) {
  
          // Tutto bene
  
          Se ($ risultato->isfreeemail()) {
  
              // L'indirizzo e-mail è gratuito, come @ gmail.com, @ hotmail.com.
  
          }
  
          / ** * L'oggetto utente contiene metadati sull'indirizzo e-mail * fornito da ZeroBounce. Tutte queste possono essere stringhe nulle o vuote *, quindi ricordati di verificarlo. * /
          $ user = $ risultato->getUser();
  
          $ user->getcountry();
          $ user->getregion();
          $ user->getzipcode();
          $ user->getcity();
          $ user->getgender();
          $ user->getFirstName();
          $ user->getLastName();
  
      } altro Se ($ risultato->getStatus() === Risultato::STATUS_DO_NOT_MAIL) {
  
          // Il codice dei sottostati ti aiuterà a determinare il problema esatto:
  
          interruttore ($ risultato->getsubstatus()) {
  
              astuccio Risultato::SUBSTATUS_DISPOSABLE:
              astuccio Risultato::SUBSTATUS_TOXIC:
                  // Tossico o monouso.
                  rompere;
  
  
              astuccio Risultato::SUBSTATUS_ROLE_BASED:
                  // admin @, helpdesk @, info @ etc; non un'e-mail personale
                  rompere;
  
              // ... e così via.
  
          }
  
      } altro Se ($ risultato->getStatus() === Risultato::STATUS_INVALID) {
  
          // E-mail non valido.
  
      } altro Se ($ risultato->getStatus() === Risultato::STATUS_SPAMTRAP) {
  
          // Trappola spam.
  
      } altro Se ($ risultato->getStatus() === Risultato::STATUS_ABUSE) {
  
          // Abuso.
  
      } altro Se ($ risultato->getStatus() === Risultato::STATUS_CATCH_ALL) {
  
          // L'indirizzo è generico; non necessariamente un'e-mail privata.
  
      } altro Se ($ risultato->getStatus() === Risultato::STATUS SCONOSCIUTO) {
  
          // Stato email sconosciuto.
  
      }
  
      / * * Per scoprire come utilizzare e reagire a diversi stati e * codici di stato secondario, consultare la documentazione di ZeroBounce all'indirizzo: * https://www.zerobounce.net/docs/?swift#version-2__v2__ * /
  
  } Catturare (
ickdnkZeroBounceAPIError $ eccezione) {
  
    // È successo qualcosa. Forse una chiave API errata o credito insufficiente.
  
  }