API-Nutzung abrufen (v2)

GET / v2 / getapiusage

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

URL-Parameter

  • Parameter
    Beschreibung
  • api-schlüssel
    Ihr API-Schlüssel befindet sich in Ihrem Konto.
  • anfangsdatum
    Das Startdatum, an dem Sie die API-Nutzung anzeigen möchten. (Format: JJJJ / MM / TT)
  • endtermin
    Das Enddatum, an dem Sie die API-Nutzung anzeigen möchten. (Format: JJJJ / MM / TT)
  • https://api.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

Die API gibt diese Ergebnisse in einem JSON-Format mit der Methode "getapiusage" zurück.

Die API gibt diese Ergebnisse in einem JSON-Format mit der Methode "getapiusage" zurück.

  • Parameter
    Beschreibung
  • Gesamt
    Gesamtzahl der Aufrufe der API
  • STATUS_VALID
    Insgesamt gültige E-Mail-Adressen, die von der API zurückgegeben werden
  • STATUS_INVALID
    Insgesamt ungültige E-Mail-Adressen, die von der API zurückgegeben wurden
  • STATUS_CATCH_ALL
    Gesamtzahl der von der API zurückgegebenen Catch-All-E-Mail-Adressen
  • STATUS_DO_NOT_MAIL
    Insgesamt senden Sie keine von der API zurückgegebenen E-Mail-Adressen
  • STATUS_SPAMTRAP
    Gesamtzahl der von der API zurückgegebenen Spamtrap-E-Mail-Adressen
  • UNBEKANNTER STATUS
    Insgesamt unbekannte E-Mail-Adressen, die von der API zurückgegeben wurden
  • sub_status_toxic
    Gesamtzahl der Fälle, in denen die API den Unterstatus "toxisch" hat.
  • sub_status_disposable
    Gesamtzahl der Fälle, in denen die API den Unterstatus "Einweg" hat
  • sub_status_role_based
    Gesamtzahl der Fälle, in denen die API den Unterstatus "role_based" hat.
  • sub_status_possible_trap
    Gesamtzahl der Fälle, in denen die API den Unterstatus "Möglich_Falle" hat.
  • sub_status_global_suppression
    Gesamtzahl der Fälle, in denen die API den Unterstatus "global_suppression" hat.
  • sub_status_timeout_exceeded
    Gesamtzahl der Fälle, in denen die API den Unterstatus "timeout_exceeded" hat.
  • sub_status_mail_server_temporary_error
    Gesamtzahl der Fälle, in denen die API den Unterstatus "mail_server_temporary_error" hat.
  • sub_status_mail_server_did_not_respond
    Gesamtanzahl der Fälle, in denen die API den Unterstatus "mail_server_did_not_respond" hat.
  • sub_status_greylisted
    Gesamtzahl der Fälle, in denen die API den Unterstatus "Grauliste" hat.
  • sub_status_antispam_system
    Gesamtzahl der Fälle, in denen die API den Unterstatus "antispam_system" hat.
  • sub_status_does_not_accept_mail
    Gesamtzahl der Fälle, in denen die API den Unterstatus "does_not_accept_mail" hat.
  • sub_status_exception_occurred
    Gesamtzahl der Fälle, in denen die API den Unterstatus "exception_occurred" hat.
  • sub_status_failed_syntax_check
    Gesamtzahl der Fälle, in denen die API den Unterstatus "failed_syntax_check" hat.
  • sub_status_mailbox_not_found
    Gesamtzahl der Fälle, in denen die API den Unterstatus "mailbox_not_found" hat.
  • sub_status_unroutable_ip_address
    Gesamtzahl der Fälle, in denen die API den Unterstatus "unroutable_ip_address" hat.
  • sub_status_possible_typo
    Gesamtzahl der Fälle, in denen die API den Unterstatus "Möglicher_Typ" hat.
  • sub_status_no_dns_entries
    Gesamtzahl der Fälle, in denen die API den Unterstatus "no_dns_entries" hat.
  • sub_status_role_based_catch_all
    Insgesamt rollenbasierte Catch-Alls Die API hat den Unterstatus "role_based_catch_all".
  • sub_status_mailbox_quota_exceeded
    Gesamtzahl der Fälle, in denen die API den Unterstatus "mailbox_quota_exceeded" hat.
  • sub_status_forcible_disconnect
    Total Forcible Disconnects Die API hat den Substatus "forcible_disconnect".
  • sub_status_failed_smtp_connection
    Insgesamt fehlgeschlagene SMTP-Verbindungen Die API hat den Unterstatus "failed_smtp_connection".
  • anfangsdatum
    Startdatum der Abfrage. (Format: JJJJ / MM / TT)
  • endtermin
    Enddatum der Abfrage. (Format: JJJJ / MM / TT)

Beispiele für API-Verwendungscodes abrufen

  • Visuelle Basis
  • C#
  • PHP
  • Java
  • Python
  • Schnell
  • Ziel c
  • Android Java
      
'Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
' https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net

  VERSUCHEN
  Dim api_key WIE Zeichenfolge = "Dein geheimer Schlüssel"
  Dim start_date WIE Zeichenfolge = "2018-01-01"
  Dim end_date  WIE Zeichenfolge = "2019-12-12" 
  Dim responseString WIE Zeichenfolge = ""

Dim apiURL WIE Zeichenfolge = "https://api.zerobounce.net/v2/getapiusage?api_key=" & api_key & "& start_date =" &  start_date & "& end_date =" & end_date

  Dim request WIE HttpWebRequest = Direktübertragung(WebRequest.Create(apiURL), HttpWebRequest)
  request.Auszeit = 150000
  request.Method = "BEKOMMEN"

  Verwenden response WIE WebResponse = request.GetResponse()
      response.GetResponseStream().ReadTimeout = 20000
      Verwenden ostream WIE NEU StreamReader(response.GetResponseStream())
          responseString = ostream.ReadToEnd()
      ENDE Verwenden
  ENDE Verwenden
Fang ex WIE exception
'Catch Exception - Alle Fehler werden hier angezeigt - wenn es Probleme mit der API gibt
ENDE VERSUCHEN
    

// Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
// 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

VERSUCHEN {
  Zeichenfolge api_key = "Dein geheimer Schlüssel";
  Zeichenfolge start_date = "2018-01-01";
  Zeichenfolge end_date = "2019-12-12";
  
  Zeichenfolge responseString = "";
  
  Zeichenfolge apiURL = "https://api.zerobounce.net/v2/getapiusage?api_key=" + api_key + "& start_date =" +  start_date + "& end_date =" + end_date;
  
  
      Httpwebrequest request = (HttpWebRequest)WebRequest.erstellen(apiURL);
      request.Timeout = 150000;
      request.Method = "BEKOMMEN";
  
      Verwenden (Antwort response = request.Erhalten Antwort()) {
          response.Getresponsestream().ReadTimeout = 20000;
          Verwenden (Streamreader ostream = NEU Streamreader(response.Getresponsestream())) {
              responseString = ostream.Readtoend();
          }
      }
      } Fang (exception ex) {
  // Catch Exception - Alle Fehler werden hier angezeigt - wenn es Probleme mit der API gibt
  }
    

  <?php
  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php

  // setze den api-schlüssel und die zu validierende e-mail
  $ api_key = "Dein geheimer Schlüssel";
  $ start_date = '2018-01-01';
  $ end_date = '2019-12-12';
  // benutze curl um die anfrage zu stellen
  $ url = 'https://api.zerobounce.net/v2/getapiusage?api_key='.$ api_key.'& start_date ='.$ start_date.'& end_date ='.$ end_date;
  
  $ ch = curl_init($ url);
  //PHP 5.5.19 und höher unterstützt TLS  1.2
  curl_setopt($ ch, CURLOPT_SSLVERSION, 6);
  curl_setopt($ ch, CURLOPT_RETURNTRANSFER, Wahr);
  curl_setopt($ ch, CURLOPT_CONNECTTIMEOUT, 15); 
  curl_setopt($ ch, CURLOPT_TIMEOUT, 150); 
  $ antwort = curl_exec($ ch);
  curl_close($ ch);
  
  // dekodiere die json-antwort
  $ json = json_decode($ antwort, Wahr);
  ?>
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  //https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java

einführen Java.io.Gepufferter Leser;
einführen Java.io.Inputstreamreader;
einführen Java.netz.Httpurlconnection;
einführen Java.netz.URL;

Öffentlichkeit Klasse Meine Klasse {

    Öffentlichkeit statisch leere main(Zeichenfolge[] args){

        Zeichenfolge key = "Dein geheimer Schlüssel";
        Zeichenfolge start_date = "2018-01-01";
        Zeichenfolge end_date = "2019-12-12"; 
        Zeichenfolge targetURL = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& start_date ="+start_date+"& end_date ="+end_date;


        Httpurlconnection connection = null;
        finale Zeichenfolge USER_AGENT = "Mozilla / 5.0";

        VERSUCHEN {
            url url = NEU url(targetURL);
            connection = (Httpurlconnection) url.offene Verbindung();
            connection.setrequestmethod("BEKOMMEN");
            connection.addrequestproperty("User-Agent", USER_AGENT);
            connection.setusecaches(Falsch);
            connection.setdooutput(Wahr);

            Gepufferter Leser in = NEU Gepufferter Leser(
                    NEU Inputstreamreader(connection.getinputstream()));
            Zeichenfolge inputLine;
            Stringbuffer response = NEU Stringbuffer();

            während ((inputLine = in.Zeile lesen()) != null) {
                response.anhängen(inputLine);
            }
            in.schließen();

            // ergebnis drucken
            System.out.println(response.toString());

        } Fang (Ausnahme e) {
            e.printstacktrace();
        } endlich {
            OB (connection != null) {
                connection.trennen();
            }
        }

    }
}
    

    # Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
    # https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
  
    
  url = "https://api.zerobounce.net/v2/getapiusage"
  api_key = "Dein geheimer Schlüssel"
  start_date = "2018-01-01" 
  end_date = "2019-12-12"
  
  
  params = {"api-schlüssel": api_key, "anfangsdatum": start_date, "endtermin":end_date}
  
  response = requests.get(url, params=params)
  
  # Drucken Sie den zurückgegebenen JSON aus
  drucken json.loads(response.content)
    
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS

lassen key = "Dein geheimer Schlüssel"
lassen start_date = "2018-01-01"
lassen end_date = "2019-12-12" // ip-adresse kann leer sein
lassen url = url(string: Zeichenfolge(format: "https://api.zerobounce.net/v2/getapiusage?api_key=%@&start_date=%@&end_date=%@", key, start_date, end_date))
lassen task = Urlsession.shared.Datenaufgabe(with: url!) { (data, response, error) im
    OB error != null {
        Nslog("Fehler (Zeichenfolge (Beschreibung: Fehler))")
    } sonst {
        machen {
            lassen parsedData = VERSUCHEN Jsonserialization.jsonobject(with: data!) WIE! [Zeichenfolge:Irgendein]
            zum (key, value) im parsedData {
                Nslog("(schlüssel) = (wert)")
            }
        } Fang {
            drucken("Fehler beim Deserialisieren von JSON: (Fehler)")
        }
    }
}
task.fortsetzen()
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS


  NSString *key = @ "Dein geheimer Schlüssel";
  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;
      OB(response!=nil)
      {
          arrResponse = [NSJSONSerialization JSONObjectWithData: response options:kNilOptions error:nil];
      }
      dispatch_async(dispatch_get_main_queue(), ^(leere) {
          zum(NSString *key im [arrResponse allKeys]) {
              Nslog(@"%@: %@",key,[arrResponse objectForKey:key]);
          }
  // rückruf (nil, arr);
      });
  });
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android

  // Zu build.gradle (App) in der Klammer "android" hinzufügen:
  useLibrary 'org.apache.http.legacy'
  
  Beispiel:
  
  android {
      compileSdkVersion 25
      useLibrary 'org.apache.http.legacy'
  }
  
  //-----------------------------------
  // Dateiname: JsonParser.java
  
  
  einführen android.os.Asynctask;
  einführen org.json.jsonobject;
  einführen Java.util.Iterator;
  
  Öffentlichkeit Klasse Hauptaktivität erweitert App-Kompatibilität {
  
      @override
      geschützt leere oncreate(Bündeln savedInstanceState) {
          super.oncreate(savedInstanceState);
  
          NEU Asynctaskparsejson().ausführen();
      }
  }
  
  Öffentlichkeit Klasse Asynctaskparsejson erweitert Asynctask<Zeichenfolge, Zeichenfolge, Zeichenfolge> {
  
      Zeichenfolge key = "Dein geheimer Schlüssel";
      Zeichenfolge start_date = "2018-01-01";
      Zeichenfolge end_date = "2019-12-12";
      Zeichenfolge url = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& start_date ="+start_date+"& end_date ="+end_date;
  
      @override
      geschützt leere onpreexecute() {
      }
  
      @override
      geschützt Zeichenfolge Hintergrund(Zeichenfolge... arg0) {
  
          Jsonparser jParser = NEU Jsonparser();
          jsonobject json = jParser.getjsonfromurl(url);
          Iterator keys = json.schlüssel();
          während( keys.hasnext() ) {
              Zeichenfolge key = (Zeichenfolge)keys.nächster();
              VERSUCHEN {
                  System.out.println("ZeroBounce:"+key+" = " +json.bekommen(key).toString());
              }
              Fang (Ausnahme e){}
          }
  
          Rückkehr null;
      }
      @override
      geschützt leere onpostexecute(Zeichenfolge strFromDoInBg) {}
  }
  
  //----------------------------------
  // Dateiname: MainActivity.java
  
  paket com.Zerobounce.zbapiandroid;
  
  einführen Java.io.Gepufferter Leser;
  einführen Java.io.Ioexception;
  einführen Java.io.Eingabestrom;
  einführen Java.io.Inputstreamreader;
  einführen Java.io.Unsupportedencodingexception;
  
  einführen org.apache.http.Httpentity;
  einführen org.apache.http.Httpresponse;
  einführen org.apache.http.klient.Clientprotocolexception;
  einführen org.apache.http.klient.methoden.Httpget;
  einführen org.apache.http.impl.klient.Defaulthttpclient;
  einführen org.json.Jsonexception;
  einführen org.json.jsonobject;
  
  einführen android.util.Log;
  
  Öffentlichkeit Klasse Jsonparser {
  
      finale Zeichenfolge TAG = "jsonparser.java";
  
      statisch Eingabestrom is = null;
      statisch jsonobject jObj = null;
      statisch Zeichenfolge json = "";
  
      Öffentlichkeit jsonobject getjsonfromurl(Zeichenfolge url) {
  
          VERSUCHEN {
  
              Defaulthttpclient httpClient = NEU Defaulthttpclient();
              Httpget httpGet = NEU Httpget(url);
  
              Httpresponse httpResponse = httpClient.ausführen(httpGet);
              Httpentity httpEntity = httpResponse.Getentität();
              is = httpEntity.Inhalt bekommen();
  
          } Fang (Unsupportedencodingexception e) {
              e.printstacktrace();
          } Fang (Clientprotocolexception e) {
              e.printstacktrace();
          } Fang (Ioexception e) {
              e.printstacktrace();
          }
  
          VERSUCHEN {
  
              Gepufferter Leser reader = NEU Gepufferter Leser(NEU Inputstreamreader(is, "iso- 8859-1"), 8);
              Stringbuilder sb = NEU Stringbuilder();
              Zeichenfolge line = null;
              während ((line = reader.Zeile lesen()) != null) {
                  sb.anhängen(line + "
");
              }
              is.schließen();
              json = sb.toString();
  
          } Fang (Ausnahme e) {
              Log.e(TAG, "Fehler beim Konvertieren des Ergebnisses" + e.toString());
          }
  
          VERSUCHEN {
              jObj = NEU jsonobject(json);
          } Fang (Jsonexception e) {
              Log.e(TAG, "Fehler beim Parsen von Daten" + e.toString());
          }
  
          Rückkehr jObj;
      }
  }
    

Endpunktantwort

Erfolgreiche Antwort

      
    {
      "gesamt": 3,
      "status_valid": 1,
      "status_invalid": 2,
      "status_catch_all": 0,
      "status_do_not_mail": 0,
      "status_spamtrap": 0,
      "unbekannter status": 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,
      "anfangsdatum": "1/1/2018",
      "endtermin": "12/12/2019"
    }
    

Fehlerantwort - API-Schlüssel

      
    {"error":"Ungültiger API-Schlüssel"}
    

Fehlerantwort - Datum

      
    {"error":"Ungültiges Datum"}