Получить использование API (v2)

GET / v2 / getapiusage

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

Параметры URL

  • ПАРАМЕТР
    Описание
  • api_key
    Ваш ключ API, найденный в вашем аккаунте.
  • дата начала
    The start date of when you want to view API usage. (format: yyyy/mm/dd)
  • дата окончания
    The end date of when you want to view API usage. (format: yyyy/mm/dd)
  • https://api.zerobounce.net/v2/getapiusage?api_key=your-api-key&start_date=2018-01-01&end_date=2019-12-12

API вернет эти результаты в формате JSON с помощью метода getapiusage.

API вернет эти результаты в формате JSON с помощью метода getapiusage.

  • ПАРАМЕТР
    Описание
  • Всего
    Общее количество вызовов API
  • STATUS_VALID
    Общее количество действительных адресов электронной почты, возвращаемых API
  • STATUS_INVALID
    Общее количество недействительных адресов электронной почты, возвращенных API
  • STATUS_CATCH_ALL
    Общее количество адресов электронной почты, возвращаемых API
  • STATUS_DO_NOT_MAIL
    Всего не отправлять адреса электронной почты, возвращаемые API
  • STATUS_SPAMTRAP
    Общее количество адресов электронной почты для спам-ловушек, возвращаемых API
  • СТАТУС НЕИЗВЕСТЕН
    Всего неизвестных адресов электронной почты, возвращенных API
  • sub_status_toxic
    Общее количество раз, когда API имеет суб-статус «токсичный»
  • sub_status_disposable
    Общее количество раз, когда API имеет суб-статус «одноразовый»
  • sub_status_role_based
    Общее количество раз, когда API имеет подчиненный статус "role_based"
  • sub_status_possible_trap
    Общее количество раз, когда API имеет суб-статус «возможный_трап»
  • sub_status_global_suppression
    Общее количество раз, когда API имел под-статус "global_suppression"
  • sub_status_timeout_exceeded
    Общее количество раз, когда API имел суб-статус "timeout_exceeded"
  • sub_status_mail_server_ contemporary_error
    Общее количество раз, когда API имеет подчиненный статус «mail_server_teven_error»
  • sub_status_mail_server_did_not_respond
    Общее количество раз, когда API имеет подчиненный статус «mail_server_did_not_respond»
  • sub_status_greylisted
    Общее количество раз, когда API имеет суб-статус «серый список»
  • sub_status_antispam_system
    Общее количество раз, когда API имеет подчиненный статус «antispam_system»
  • sub_status_does_not_accept_mail
    Общее количество раз, когда API имел суб-статус "does_not_accept_mail"
  • sub_status_exception_occurred
    Общее количество раз, когда API имел суб-статус "exception_occurred"
  • sub_status_failed_syntax_check
    Общее количество раз, когда API имел суб-статус "failed_syntax_check"
  • sub_status_mailbox_not_found
    Общее количество раз, когда API имел суб-статус "mailbox_not_found"
  • sub_status_unroutable_ip_address
    Общее количество раз, когда API имел под-статус unroutable_ip_address
  • sub_status_possible_typo
    Общее количество раз, когда API имел суб-статус "possible_typo"
  • sub_status_no_dns_entries
    Общее количество раз, когда API имеет подчиненный статус «no_dns_entries»
  • sub_status_role_based_catch_all
    Всего на основе ролей поймать все API имеет подчиненный статус "role_based_catch_all"
  • sub_status_mailbox_quota_exceeded
    Общее количество раз, когда API имел суб-статус "mailbox_quota_exceeded"
  • sub_status_forcible_disconnect
    Полное принудительное отключение API имеет суб-статус "forcible_disconnect"
  • sub_status_failed_smtp_connection
    Общее количество неудачных SMTP-подключений, у API суб-статус «failed_smtp_connection»
  • дата начала
    Start date of query. (format: yyyy/mm/dd)
  • дата окончания
    End date of query. (format: yyyy/mm/dd)

Получить примеры кода использования API

  • Visual Basic
  • C#
  • PHP
  • Ява
  • Питон
  • СВИФТ
  • Цель С
  • Android Java
      
Полные библиотеки API и оболочки могут быть найдены здесь: 
' https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net

  Пытаться
  Тусклый api_key Как Строка = «Твой секретный ключ»
  Тусклый start_date Как Строка = "2018-01-01"
  Тусклый end_date  Как Строка = "2019-12-12" 
  Тусклый responseString Как Строка = ""

Тусклый apiURL Как Строка = "https://api.zerobounce.net/v2/getapiusage?api_key=" & api_key & "& дата_начала =" &  start_date & "& end_date =" & end_date

  Тусклый request Как HttpWebRequest = Прямая трансляция(WebRequest.Create(apiURL), HttpWebRequest)
  request.Тайм-аут = 150000
  request.Method = "ПОЛУЧИТЬ"

  С помощью response Как WebResponse = request.GetResponse()
      response.GetResponseStream().ReadTimeout = 20000
      С помощью ostream Как Новый StreamReader(response.GetResponseStream())
          responseString = ostream.ReadToEnd()
      Конец С помощью
  Конец С помощью
Поймать ex Как exception
'Catch Exception - здесь будут показаны все ошибки - если есть проблемы с API
Конец Пытаться
    

// Полные библиотеки API и оболочки могут быть найдены здесь: 
// 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

Пытаться {
  Строка api_key = «Твой секретный ключ»;
  Строка start_date = "2018-01-01";
  Строка end_date = "2019-12-12";
  
  Строка responseString = "";
  
  Строка apiURL = "https://api.zerobounce.net/v2/getapiusage?api_key=" + api_key + "& дата_начала =" +  start_date + "& end_date =" + end_date;
  
  
      Httpwebrequest request = (HttpWebRequest)WebRequest.создайте(apiURL);
      request.Timeout = 150000;
      request.Method = "ПОЛУЧИТЬ";
  
      С помощью (Веб-ответ response = request.GetResponse()) {
          response.Getresponsestream().ReadTimeout = 20000;
          С помощью (StreamReader ostream = Новый StreamReader(response.Getresponsestream())) {
              responseString = ostream.До конца();
          }
      }
      } Поймать (exception ex) {
  // Catch Exception - все ошибки будут показаны здесь - если есть проблемы с API
  }
    

  <?php
  // Полные библиотеки API и оболочки могут быть найдены здесь: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php

  // установить ключ api и адрес электронной почты для проверки
  $ api_key = «Твой секретный ключ»;
  $ start_date = '2018-01-01';
  $ end_date = '2019-12-12';
  // используем curl для выполнения запроса
  $ url = 'https://api.zerobounce.net/v2/getapiusage?api_key='.$ api_key.'& дата_начала ='.$ start_date.'& дата_окончание ='.$ end_date;
  
  $ ch = curl_init($ url);
  //PHP‹0 Event.ndom1} и выше имеет поддержку TLS  1.2
  curl_setopt($ ch, CURLOPT_SSLVERSION, 6);
  curl_setopt($ ch, CURLOPT_RETURNTRANSFER, Правда);
  curl_setopt($ ch, CURLOPT_CONNECTTIMEOUT, 15); 
  curl_setopt($ ch, CURLOPT_TIMEOUT, 150); 
  $ ответ = curl_exec($ ch);
  curl_close($ ch);
  
  // декодировать ответ json
  $ json = json_decode($ ответ, Правда);
  ?>
    


  // Полные библиотеки API и оболочки могут быть найдены здесь: 
  //https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java

импортировать Ява.и.о..Буфер чтения;
импортировать Ява.и.о..Inputstreamreader;
импортировать Ява.сеть.HttpURLConnection;
импортировать Ява.сеть.URL;

Общественности Класс Мой класс {

    Общественности статический пустота главный(Строка[] args){

        Строка key = «Твой секретный ключ»;
        Строка start_date = "2018-01-01";
        Строка end_date = "2019-12-12"; 
        Строка targetURL = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& дата_начала ="+start_date+"& end_date ="+end_date;


        HttpURLConnection connection = ноль;
        окончательный Строка USER_AGENT = "Mozilla / 5.0";

        Пытаться {
            url url = Новый url(targetURL);
            connection = (HttpURLConnection) url.OpenConnection();
            connection.setrequestmethod("ПОЛУЧИТЬ");
            connection.addrequestproperty(«Пользователь-агент», USER_AGENT);
            connection.setusecaches(Ложь);
            connection.setdooutput(Правда);

            Буфер чтения in = Новый Буфер чтения(
                    Новый Inputstreamreader(connection.getinputstream()));
            Строка inputLine;
            Струнный буфер response = Новый Струнный буфер();

            пока ((inputLine = in.ReadLine()) != ноль) {
                response.append(inputLine);
            }
            in.близко();

            // распечатать результат
            Система.out.println(response.toString());

        } Поймать (Исключение e) {
            e.printstacktrace();
        } в конце концов {
            Если (connection != ноль) {
                connection.отключить();
            }
        }

    }
}
    

    # Полные библиотеки API и оболочки могут быть найдены здесь: 
    # https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
  
    
  url = "https://api.zerobounce.net/v2/getapiusage"
  api_key = «Твой секретный ключ»
  start_date = "2018-01-01" 
  end_date = "2019-12-12"
  
  
  params = {"api_key": api_key, "дата начала": start_date, "дата окончания":end_date}
  
  response = requests.get(url, params=params)
  
  # Распечатать возвращенный json
  распечатать json.loads(response.content)
    
    


  // Полные библиотеки API и оболочки могут быть найдены здесь: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS

позволяь key = «Твой секретный ключ»
позволяь start_date = "2018-01-01"
позволяь end_date = "2019-12-12" // ip-адрес может быть пустым
позволяь url = url(string: Строка(format: "https://api.zerobounce.net/v2/getapiusage?api_key=%@&start_date=%@&end_date=%@", key, start_date, end_date))
позволяь task = Urlsession.shared.datatask(with: url!) { (data, response, error) в
    Если error != нль {
        NSLog(«Ошибка (строка (описание: ошибка))»)
    } еще {
        делать {
            позволяь parsedData = Пытаться Jsonserialization.jsonobject(with: data!) Как! [Строка:Любые]
            для (key, value) в parsedData {
                NSLog("(ключ) = (значение)")
            }
        } Поймать {
            распечатать(«Ошибка десериализации JSON: (ошибка)»)
        }
    }
}
task.продолжить()
    


  // Полные библиотеки API и оболочки могут быть найдены здесь: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS


  NSString *key = @ "Твой секретный ключ";
  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;
      Если(response!=nil)
      {
          arrResponse = [NSJSONSerialization JSONObjectWithData: response options:kNilOptions error:nil];
      }
      dispatch_async(dispatch_get_main_queue(), ^(пустота) {
          для(NSString *key в [arrResponse allKeys]) {
              NSLog(@"%@: %@",key,[arrResponse objectForKey:key]);
          }
  // обратный вызов (nil, arr);
      });
  });
    


  // Полные библиотеки API и оболочки могут быть найдены здесь: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android

  // Добавляем в build.gradle (App) в скобку "android":
  useLibrary 'org.apache.http.legacy'
  
  Пример:
  
  android {
      compileSdkVersion 25
      useLibrary 'org.apache.http.legacy'
  }
  
  //-----------------------------------
  // Имя файла: JsonParser.java
  
  
  импортировать андроид.операционные системы.Асинхронность;
  импортировать организация.json.jsonobject;
  импортировать Ява.util.Итератор;
  
  Общественности Класс Основное занятие продолжается Appcompatactivity {
  
      @Override
      защищенный пустота создавать(Сверток savedInstanceState) {
          супер.создавать(savedInstanceState);
  
          Новый Asynctaskparsejson().выполнять();
      }
  }
  
  Общественности Класс Asynctaskparsejson продолжается Асинхронность<Строка, Строка, Строка> {
  
      Строка key = «Твой секретный ключ»;
      Строка start_date = "2018-01-01";
      Строка end_date = "2019-12-12";
      Строка url = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& дата_начала ="+start_date+"& end_date ="+end_date;
  
      @Override
      защищенный пустота onpreexecute() {
      }
  
      @Override
      защищенный Строка doinbackground(Строка... arg0) {
  
          Jsonparser jParser = Новый Jsonparser();
          jsonobject json = jParser.getjsonfromurl(url);
          Итератор keys = json.ключи();
          пока( keys.hasnext() ) {
              Строка key = (Строка)keys.следующий();
              Пытаться {
                  Система.out.println("ZeroBounce:"+key+" = " +json.получить(key).toString());
              }
              Поймать (Исключение e){}
          }
  
          Вернуть ноль;
      }
      @Override
      защищенный пустота onpostexecute(Строка strFromDoInBg) {}
  }
  
  //----------------------------------
  // Имя айла: MainActivity.java
  
  пакет ком.Zerobounce.zbapiandroid;
  
  импортировать Ява.и.о..Буфер чтения;
  импортировать Ява.и.о..IOException;
  импортировать Ява.и.о..Входной поток;
  импортировать Ява.и.о..Inputstreamreader;
  импортировать Ява.и.о..UnsupportedEncodingException;
  
  импортировать организация.apache.http.Httpentity;
  импортировать организация.apache.http.Httpresponse;
  импортировать организация.apache.http.клиент.Clientprotocolexception;
  импортировать организация.apache.http.клиент.методы.Httpget;
  импортировать организация.apache.http.имп.клиент.Defaulthttpclient;
  импортировать организация.json.Jsonexception;
  импортировать организация.json.jsonobject;
  
  импортировать андроид.util.Журнал;
  
  Общественности Класс Jsonparser {
  
      окончательный Строка TAG = "Jsonparser.java";
  
      статический Входной поток is = ноль;
      статический jsonobject jObj = ноль;
      статический Строка json = "";
  
      Общественности jsonobject getjsonfromurl(Строка url) {
  
          Пытаться {
  
              Defaulthttpclient httpClient = Новый Defaulthttpclient();
              Httpget httpGet = Новый Httpget(url);
  
              Httpresponse httpResponse = httpClient.выполнять(httpGet);
              Httpentity httpEntity = httpResponse.GetEntity();
              is = httpEntity.getcontent();
  
          } Поймать (UnsupportedEncodingException e) {
              e.printstacktrace();
          } Поймать (Clientprotocolexception e) {
              e.printstacktrace();
          } Поймать (IOException e) {
              e.printstacktrace();
          }
  
          Пытаться {
  
              Буфер чтения reader = Новый Буфер чтения(Новый Inputstreamreader(is, "изо- 8859-1"), 8);
              StringBuilder sb = Новый StringBuilder();
              Строка line = ноль;
              пока ((line = reader.ReadLine()) != ноль) {
                  sb.append(line + "
");
              }
              is.близко();
              json = sb.toString();
  
          } Поймать (Исключение e) {
              Журнал.e(TAG, «Ошибка преобразования результата» + e.toString());
          }
  
          Пытаться {
              jObj = Новый jsonobject(json);
          } Поймать (Jsonexception e) {
              Журнал.e(TAG, «Ошибка разбора данных» + e.toString());
          }
  
          Вернуть jObj;
      }
  }
    

Ответ конечной точки

Успешный ответ

      
    {
      "общее количество": 3,
      "status_valid": 1,
      "status_invalid": 2,
      "status_catch_all": 0,
      "status_do_not_mail": 0,
      "status_spamtrap": 0,
      "статус неизвестен": 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_ contemporary_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,
      "дата начала": "1/1/2018",
      "дата окончания": "12/12/2019"
    }
    

Ответ об ошибке - ключ API

      
    {"ошибка":«Неверный ключ API»}
    

Ответ об ошибке - Дата

      
    {"ошибка":"Недействительная дата"}