Ottieni utilizzo API (v2)

GET / v2 / getapiusage

URL API: https://bulkapi.zerobounce.net/v2/getapiusage

Parametri URL

  • Parametro
    Descrizione
  • api_key
    La tua chiave API, che si trova nel tuo account.
  • data d'inizio
    La data di inizio in cui desideri visualizzare l'utilizzo dell'API. (formato: aaaa / mm / gg)
  • data di fine
    La data di fine in cui desideri visualizzare l'utilizzo dell'API. (formato: aaaa / mm / gg)
  • https://api.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

L'API restituirà questi risultati in un formato JSON utilizzando il metodo "getapiusage".

L'API restituirà questi risultati in un formato JSON utilizzando il metodo "getapiusage".

  • Parametro
    Descrizione
  • Totale
    Numero totale di volte in cui l'API è stata chiamata
  • STATUS_VALID
    Indirizzi email validi totali restituiti dall'API
  • STATUS_INVALID
    Totale indirizzi email non validi restituiti dall'API
  • STATUS_CATCH_ALL
    Indirizzi email catch-all totali restituiti dall'API
  • STATUS_DO_NOT_MAIL
    Totale non inviare indirizzi di posta elettronica restituiti dall'API
  • STATUS_SPAMTRAP
    Indirizzi email spamtrap totali restituiti dall'API
  • STATUS SCONOSCIUTO
    Indirizzi email sconosciuti totali restituiti dall'API
  • sub_status_toxic
    Numero totale di volte in cui l'API ha uno stato secondario "tossico"
  • sub_status_disposable
    Numero totale di volte in cui l'API ha uno stato secondario "usa e getta"
  • sub_status_role_based
    Numero totale di volte in cui l'API ha uno stato secondario "role_based"
  • sub_status_possible_trap
    Numero totale di volte in cui l'API ha uno stato secondario "possible_trap"
  • sub_status_global_suppression
    Numero totale di volte in cui l'API ha uno stato secondario "global_suppression"
  • sub_status_timeout_exceeded
    Numero totale di volte in cui l'API ha uno stato secondario "timeout_exceeded"
  • sub_status_mail_server_temporary_error
    Numero totale di volte in cui l'API ha uno stato secondario "mail_server_temporary_error"
  • sub_status_mail_server_did_not_respond
    Numero totale di volte in cui l'API ha uno stato secondario "mail_server_did_not_respond"
  • sub_status_greylisted
    Numero totale di volte in cui l'API ha uno stato secondario "greylisted"
  • sub_status_antispam_system
    Numero totale di volte in cui l'API ha uno stato secondario "antispam_system"
  • sub_status_does_not_accept_mail
    Numero totale di volte in cui l'API ha uno stato secondario "does_not_accept_mail"
  • sub_status_exception_occurred
    Numero totale di volte in cui l'API ha uno stato secondario "exception_occurred"
  • sub_status_failed_syntax_check
    Numero totale di volte in cui l'API ha uno stato secondario "failed_syntax_check"
  • sub_status_mailbox_not_found
    Numero totale di volte in cui l'API ha uno stato secondario "mailbox_not_found"
  • sub_status_unroutable_ip_address
    Numero totale di volte in cui l'API ha uno stato secondario "unroutable_ip_address"
  • sub_status_possible_typo
    Numero totale di volte in cui l'API ha uno stato secondario "possible_typo"
  • sub_status_no_dns_entries
    Numero totale di volte in cui l'API ha uno stato secondario "no_dns_entries"
  • sub_status_role_based_catch_all
    Tutti i rilevamenti basati sui ruoli, l'API ha uno stato secondario "role_based_catch_all"
  • sub_status_mailbox_quota_exceeded
    Numero totale di volte in cui l'API ha uno stato secondario "mailbox_quota_exceeded"
  • sub_status_forcible_disconnect
    Totale disconnessioni forzate l'API ha uno stato secondario "forcible_disconnect"
  • sub_status_failed_smtp_connection
    Totale connessioni SMTP non riuscite l'API ha uno stato secondario di "failed_smtp_connection"
  • data d'inizio
    Data di inizio della query. (formato: aaaa / mm / gg)
  • data di fine
    Data di fine della query. (formato: aaaa / mm / gg)

Ottieni esempi di codice di utilizzo API

  • Visual Basic
  • C#
  • PHP
  • Giava
  • Pitone
  • Veloce
  • Obiettivo C
  • Android Java
      
'Librerie API complete e wrapper sono disponibili qui: 
' https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net

  PROVARE
  Fioco api_key Come Corda = "La tua chiave segreta"
  Fioco start_date Come Corda = "2018-01-01"
  Fioco end_date  Come Corda = "2019-12-12" 
  Fioco responseString Come Corda = ""

Fioco apiURL Come Corda = "https://api.zerobounce.net/v2/getapiusage?api_key=" & api_key & "& data_inizio =" &  start_date & "& end_date =" & end_date

  Fioco request Come HttpWebRequest = Directcast(WebRequest.Create(apiURL), HttpWebRequest)
  request.Tempo scaduto = 150000
  request.Method = "OTTENERE"

  Utilizzando response Come WebResponse = request.GetResponse()
      response.GetResponseStream().ReadTimeout = 20000
      Utilizzando ostream Come Nuovo StreamReader(response.GetResponseStream())
          responseString = ostream.ReadToEnd()
      Fine Utilizzando
  Fine Utilizzando
Catturare ex Come exception
'Eccezione di cattura - Tutti gli errori verranno visualizzati qui - se ci sono problemi con l'API
Fine PROVARE
    

// Le librerie e i wrapper API completi sono disponibili qui: 
// https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net
// https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__c-sharp

PROVARE {
  Corda api_key = "La tua chiave segreta";
  Corda start_date = "2018-01-01";
  Corda end_date = "2019-12-12";
  
  Corda responseString = "";
  
  Corda apiURL = "https://api.zerobounce.net/v2/getapiusage?api_key=" + api_key + "& data_inizio =" +  start_date + "& end_date =" + end_date;
  
  
      Httpwebrequest request = (HttpWebRequest)WebRequest.creare(apiURL);
      request.Timeout = 150000;
      request.Method = "OTTENERE";
  
      Utilizzando (Webresponse response = request.GetResponse()) {
          response.Getresponsestream().ReadTimeout = 20000;
          Utilizzando (Streamreader ostream = Nuovo Streamreader(response.Getresponsestream())) {
              responseString = ostream.Readtoend();
          }
      }
      } Catturare (exception ex) {
  // Eccezione di cattura: qui verranno visualizzati tutti gli errori, in caso di problemi con l'API
  }
    

  <?php
  // Le librerie e i wrapper API completi sono disponibili qui: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php

  // imposta la chiave api e l'e-mail da convalidare
  $ api_key = "La tua chiave segreta";
  $ data_inizio = '2018-01-01';
  $ end_date = '2019-12-12';
  // usa curl per fare la richiesta
  $ url = 'https://api.zerobounce.net/v2/getapiusage?api_key='.$ api_key."& start_date =".$ data_inizio."& end_date =".$ end_date;
  
  $ ch = curl_init($ url);
  //PHP 5.5.19 e versioni successive supportano TLS  1.2
  curl_setopt($ ch, CURLOPT_SSLVERSION, 6);
  curl_setopt($ ch, CURLOPT_RETURNTRANSFER, Vero);
  curl_setopt($ ch, CURLOPT_CONNECTTIMEOUT, 15); 
  curl_setopt($ ch, CURLOPT_TIMEOUT, 150); 
  $ risposta = curl_exec($ ch);
  curl_close($ ch);
  
  // decodifica la risposta json
  $ json = json_decode($ risposta, Vero);
  ?>
    


  // Le librerie e i wrapper API completi sono disponibili qui: 
  //https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java

importare Giava.io.Bufferedreader;
importare Giava.io.Inputstreamreader;
importare Giava.netto.Httpurlconnection;
importare Giava.netto.URL;

Pubblico Classe La mia classe {

    Pubblico statico vuoto principale(Corda[] args){

        Corda key = "La tua chiave segreta";
        Corda start_date = "2018-01-01";
        Corda end_date = "2019-12-12"; 
        Corda targetURL = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& data_inizio ="+start_date+"& end_date ="+end_date;


        Httpurlconnection connection = nullo;
        finale Corda USER_AGENT = "Mozilla / 5.0";

        PROVARE {
            url url = Nuovo url(targetURL);
            connection = (Httpurlconnection) url.connessione aperta();
            connection.setrequestmethod("OTTENERE");
            connection.addrequestproperty("user-agent", USER_AGENT);
            connection.setusecaches(Falso);
            connection.setdooutput(Vero);

            Bufferedreader in = Nuovo Bufferedreader(
                    Nuovo Inputstreamreader(connection.getinputstream()));
            Corda inputLine;
            Stringbuffer response = Nuovo Stringbuffer();

            mentre ((inputLine = in.linea di lettura()) != nullo) {
                response.aggiungere(inputLine);
            }
            in.vicino();

            // stampa il risultato
            Sistema.out.println(response.toString());

        } Catturare (Eccezione e) {
            e.printstacktrace();
        } finalmente {
            Se (connection != nullo) {
                connection.disconnect();
            }
        }

    }
}
    

    # Librerie e wrapper API completi sono disponibili qui: 
    # https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
  
    
  url = "https://api.zerobounce.net/v2/getapiusage"
  api_key = "La tua chiave segreta"
  start_date = "2018-01-01" 
  end_date = "2019-12-12"
  
  
  params = {"api_key": api_key, "data d'inizio": start_date, "data di fine":end_date}
  
  response = requests.get(url, params=params)
  
  # Stampa il json restituito
  stampare json.loads(response.content)
    
    


  // Le librerie e i wrapper API completi sono disponibili qui: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS

permettere key = "La tua chiave segreta"
permettere start_date = "2018-01-01"
permettere end_date = "2019-12-12" // l'indirizzo ip può essere vuoto
permettere url = url(string: Corda(format: "https://api.zerobounce.net/v2/getapiusage?api_key=%@&start_date=%@&end_date=%@", key, start_date, end_date))
permettere task = Urlsession.shared.datatask(with: url!) { (data, response, error) in
    Se error != zero {
        NSLog("Errore (stringa (che descrive: errore))")
    } altro {
        fare {
            permettere parsedData = PROVARE Jsonserialization.jsonobject(with: data!) Come! [Corda:Qualunque]
            per (key, value) in parsedData {
                NSLog("(chiave) = (valore)")
            }
        } Catturare {
            stampare("Errore durante la deserializzazione di JSON: (errore)")
        }
    }
}
task.curriculum vitae()
    


  // Le librerie e i wrapper API completi sono disponibili qui: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS


  NSString *key = @ "La tua chiave segreta";
  NSString *start_date = @"2018-01-01";
  NSString *end_date = @"2019-12-12"; 
  
  NSString *urlString = [NSString stringWithFormat:@"https://api.zerobounce.net/v2/getapiusage?api_key=%@&start_date=%@&end_date=%@", key, start_date, end_date];
  
  __block NSURL *url = [NSURL URLWithString:urlString];
  
  dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
  
      NSData *response = [NSData dataWithContentsOfURL:url];
      NSDictionary *arrResponse = nil;
      Se(response!=nil)
      {
          arrResponse = [NSJSONSerialization JSONObjectWithData: response options:kNilOptions error:nil];
      }
      dispatch_async(dispatch_get_main_queue(), ^(vuoto) {
          per(NSString *key in [arrResponse allKeys]) {
              NSLog(@"%@: %@",key,[arrResponse objectForKey:key]);
          }
  // callback (nil, arr);
      });
  });
    


  // Le librerie e i wrapper API completi sono disponibili qui: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android

  // Aggiungi a build.gradle (App) nella parentesi "android":
  useLibrary "org.apache.http.legacy"
  
  Esempio:
  
  android {
      compileSdkVersion 25
      useLibrary "org.apache.http.legacy"
  }
  
  //-----------------------------------
  // Nome file: JsonParser.java
  
  
  importare androide.os.Asynctask;
  importare org.json.jsonobject;
  importare Giava.util.Iteratore;
  
  Pubblico Classe Attività principale si estende Appcompatactivity {
  
      @Oltrepassare
      protetto vuoto oncreate(Impacchettare savedInstanceState) {
          super.oncreate(savedInstanceState);
  
          Nuovo Asynctaskparsejson().eseguire();
      }
  }
  
  Pubblico Classe Asynctaskparsejson si estende Asynctask<Corda, Corda, Corda> {
  
      Corda key = "La tua chiave segreta";
      Corda start_date = "2018-01-01";
      Corda end_date = "2019-12-12";
      Corda url = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& data_inizio ="+start_date+"& end_date ="+end_date;
  
      @Oltrepassare
      protetto vuoto onpreexecute() {
      }
  
      @Oltrepassare
      protetto Corda doinbackground(Corda... arg0) {
  
          Jsonparser jParser = Nuovo Jsonparser();
          jsonobject json = jParser.getjsonfromurl(url);
          Iteratore keys = json.chiavi();
          mentre( keys.hasnext() ) {
              Corda key = (Corda)keys.il prossimo();
              PROVARE {
                  Sistema.out.println("ZeroBounce:"+key+" = " +json.ottenere(key).toString());
              }
              Catturare (Eccezione e){}
          }
  
          Ritorno nullo;
      }
      @Oltrepassare
      protetto vuoto onpostexecute(Corda strFromDoInBg) {}
  }
  
  //----------------------------------
  // Nome file: MainActivity.java
  
  pacchetto com.Zerobounce.zbapiandroid;
  
  importare Giava.io.Bufferedreader;
  importare Giava.io.Ioexception;
  importare Giava.io.Inputstream;
  importare Giava.io.Inputstreamreader;
  importare Giava.io.Eccezione di codifica non supportata;
  
  importare org.apache.http.Httpentity;
  importare org.apache.http.Http: //presponse;
  importare org.apache.http.cliente.Clientprotocolexception;
  importare org.apache.http.cliente.metodi.Httpget;
  importare org.apache.http.impl.cliente.Defaulthttpclient;
  importare org.json.Jsonexception;
  importare org.json.jsonobject;
  
  importare androide.util.Ceppo;
  
  Pubblico Classe Jsonparser {
  
      finale Corda TAG = "jsonparser.java";
  
      statico Inputstream is = nullo;
      statico jsonobject jObj = nullo;
      statico Corda json = "";
  
      Pubblico jsonobject getjsonfromurl(Corda url) {
  
          PROVARE {
  
              Defaulthttpclient httpClient = Nuovo Defaulthttpclient();
              Httpget httpGet = Nuovo Httpget(url);
  
              Http: //presponse httpResponse = httpClient.eseguire(httpGet);
              Httpentity httpEntity = httpResponse.getentity();
              is = httpEntity.getcontent();
  
          } Catturare (Eccezione di codifica non supportata e) {
              e.printstacktrace();
          } Catturare (Clientprotocolexception e) {
              e.printstacktrace();
          } Catturare (Ioexception e) {
              e.printstacktrace();
          }
  
          PROVARE {
  
              Bufferedreader reader = Nuovo Bufferedreader(Nuovo Inputstreamreader(is, "iso- 8859-1"), 8);
              Stringbuilder sb = Nuovo Stringbuilder();
              Corda line = nullo;
              mentre ((line = reader.linea di lettura()) != nullo) {
                  sb.aggiungere(line + "
");
              }
              is.vicino();
              json = sb.toString();
  
          } Catturare (Eccezione e) {
              Ceppo.e(TAG, "Errore durante la conversione del risultato" + e.toString());
          }
  
          PROVARE {
              jObj = Nuovo jsonobject(json);
          } Catturare (Jsonexception e) {
              Ceppo.e(TAG, "Errore durante l'analisi dei dati" + e.toString());
          }
  
          Ritorno jObj;
      }
  }
    

Risposta dell'endpoint

Risposta riuscita

      
    {
      "totale": 3,
      "status_valid": 1,
      "status_invalid": 2,
      "status_catch_all": 0,
      "status_do_not_mail": 0,
      "status_spamtrap": 0,
      "status sconosciuto": 0,
      "sub_status_toxic": 0,
      "sub_status_disposable": 0,
      "sub_status_role_based": 0,
      "sub_status_possible_trap": 0,
      "sub_status_global_suppression": 0,
      "sub_status_timeout_exceeded": 0,
      "sub_status_mail_server_temporary_error": 0,
      "sub_status_mail_server_did_not_respond": 0,
      "sub_status_greylisted": 0,
      "sub_status_antispam_system": 0,
      "sub_status_does_not_accept_mail": 0,
      "sub_status_exception_occurred": 0,
      "sub_status_failed_syntax_check": 0,
      "sub_status_mailbox_not_found": 2,
      "sub_status_unroutable_ip_address": 0,
      "sub_status_possible_typo": 0,
      "sub_status_no_dns_entries": 0,
      "sub_status_role_based_catch_all": 0,
      "sub_status_mailbox_quota_exceeded": 0,
      "sub_status_forcible_disconnect": 0,
      "sub_status_failed_smtp_connection": 0,
      "data d'inizio": "1/1/2018",
      "data di fine": "12/12/2019"
    }
    

Risposta di errore - Chiave API

      
    {"errore":"Chiave API non valida"}
    

Risposta di errore - Data

      
    {"errore":"Data non valida"}