Ottieni utilizzo API (v2)
GET / v2 / getapiusage
URL API: https://bulkapi.zerobounce.net/v2/getapiusage
Parametri URL
- ParametroDescrizione
- api_keyLa tua chiave API, che si trova nel tuo account.
- data d'inizioLa data di inizio in cui desideri visualizzare l'utilizzo dell'API. (formato: aaaa / mm / gg)
- data di fineLa 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".
- ParametroDescrizione
- TotaleNumero totale di volte in cui l'API è stata chiamata
- STATUS_VALIDIndirizzi email validi totali restituiti dall'API
- STATUS_INVALIDTotale indirizzi email non validi restituiti dall'API
- STATUS_CATCH_ALLIndirizzi email catch-all totali restituiti dall'API
- STATUS_DO_NOT_MAILTotale non inviare indirizzi di posta elettronica restituiti dall'API
- STATUS_SPAMTRAPIndirizzi email spamtrap totali restituiti dall'API
- STATUS SCONOSCIUTOIndirizzi email sconosciuti totali restituiti dall'API
- sub_status_toxicNumero totale di volte in cui l'API ha uno stato secondario "tossico"
- sub_status_disposableNumero totale di volte in cui l'API ha uno stato secondario "usa e getta"
- sub_status_role_basedNumero totale di volte in cui l'API ha uno stato secondario "role_based"
- sub_status_possible_trapNumero totale di volte in cui l'API ha uno stato secondario "possible_trap"
- sub_status_global_suppressionNumero totale di volte in cui l'API ha uno stato secondario "global_suppression"
- sub_status_timeout_exceededNumero totale di volte in cui l'API ha uno stato secondario "timeout_exceeded"
- sub_status_mail_server_temporary_errorNumero totale di volte in cui l'API ha uno stato secondario "mail_server_temporary_error"
- sub_status_mail_server_did_not_respondNumero totale di volte in cui l'API ha uno stato secondario "mail_server_did_not_respond"
- sub_status_greylistedNumero totale di volte in cui l'API ha uno stato secondario "greylisted"
- sub_status_antispam_systemNumero totale di volte in cui l'API ha uno stato secondario "antispam_system"
- sub_status_does_not_accept_mailNumero totale di volte in cui l'API ha uno stato secondario "does_not_accept_mail"
- sub_status_exception_occurredNumero totale di volte in cui l'API ha uno stato secondario "exception_occurred"
- sub_status_failed_syntax_checkNumero totale di volte in cui l'API ha uno stato secondario "failed_syntax_check"
- sub_status_mailbox_not_foundNumero totale di volte in cui l'API ha uno stato secondario "mailbox_not_found"
- sub_status_unroutable_ip_addressNumero totale di volte in cui l'API ha uno stato secondario "unroutable_ip_address"
- sub_status_possible_typoNumero totale di volte in cui l'API ha uno stato secondario "possible_typo"
- sub_status_no_dns_entriesNumero totale di volte in cui l'API ha uno stato secondario "no_dns_entries"
- sub_status_role_based_catch_allTutti i rilevamenti basati sui ruoli, l'API ha uno stato secondario "role_based_catch_all"
- sub_status_mailbox_quota_exceededNumero totale di volte in cui l'API ha uno stato secondario "mailbox_quota_exceeded"
- sub_status_forcible_disconnectTotale disconnessioni forzate l'API ha uno stato secondario "forcible_disconnect"
- sub_status_failed_smtp_connectionTotale connessioni SMTP non riuscite l'API ha uno stato secondario di "failed_smtp_connection"
- data d'inizioData di inizio della query. (formato: aaaa / mm / gg)
- data di fineData di fine della query. (formato: aaaa / mm / gg)
Ottieni esempi di codice di utilizzo API
'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"}