Obtener uso de API (v2)
GET / v2 / getapiusage
URL de API: https://bulkapi.zerobounce.net/v2/getapiusage
Parámetros URL
- ParámetroDescripción
- clave apiSu clave API, que se encuentra en su cuenta.
- fecha de inicioThe start date of when you want to view API usage. (format: yyyy/mm/dd)
- fecha finalThe 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
La API devolverá estos resultados en formato JSON utilizando el método "getapiusage".
La API devolverá estos resultados en formato JSON utilizando el método "getapiusage".
- ParámetroDescripción
- TotalNúmero total de veces que se ha llamado a la API
- ESTADO_VÁLIDOTotal de direcciones de correo electrónico válidas devueltas por la API
- ESTADO_INVÁLIDOTotal de direcciones de correo electrónico no válidas devueltas por la API
- STATUS_CATCH_ALLTotal de direcciones de correo electrónico generales devueltas por la API
- STATUS_DO_NOT_MAILTotal de direcciones de correo electrónico no enviadas por la API
- STATUS_SPAMTRAPTotal de direcciones de correo electrónico de spam devueltas por la API
- ESTADO DESCONOCIDOTotal de direcciones de correo electrónico desconocidas devueltas por la API
- sub_status_toxicNúmero total de veces que la API tiene un estado secundario de "tóxico"
- sub_status_disposableNúmero total de veces que la API tiene un estado secundario de "desechable"
- sub_status_role_basedNúmero total de veces que la API tiene un sub estado de "role_based"
- sub_status_possible_trapNúmero total de veces que la API tiene un estado secundario de "posible_trap"
- sub_status_global_suppressionNúmero total de veces que la API tiene un estado secundario de "global_suppression"
- sub_status_timeout_exceededNúmero total de veces que la API tiene un estado secundario de "timeout_exceeded"
- sub_status_mail_server_temporary_errorNúmero total de veces que la API tiene un subestado de "mail_server_temporary_error"
- sub_status_mail_server_did_not_respondNúmero total de veces que la API tiene un estado secundario de "mail_server_did_not_respond"
- sub_status_greylistedNúmero total de veces que la API tiene un estado secundario de "lista gris"
- sub_status_antispam_systemNúmero total de veces que la API tiene un estado secundario de "antispam_system"
- sub_status_does_not_accept_mailNúmero total de veces que la API tiene un estado secundario de "does_not_accept_mail"
- sub_status_exception_occurredNúmero total de veces que la API tiene un estado secundario de "excepción_currida"
- sub_status_failed_syntax_checkNúmero total de veces que la API tiene un estado secundario de "failure_syntax_check"
- sub_status_mailbox_not_foundNúmero total de veces que la API tiene un estado secundario de "buzón_no_encontrado"
- sub_status_unroutable_ip_addressNúmero total de veces que la API tiene un estado secundario de "unroutable_ip_address"
- sub_status_possible_typoNúmero total de veces que la API tiene un estado secundario de "possible_typo"
- sub_status_no_dns_entriesNúmero total de veces que la API tiene un estado secundario de "no_dns_entries"
- sub_status_role_based_catch_allTotal basado en roles para capturar todos, la API tiene un estado secundario de "role_based_catch_all"
- sub_status_mailbox_quota_exceededNúmero total de veces que la API tiene un estado secundario de "buzón_cuota_excedida"
- sub_status_forcible_disconnectTotal de desconexiones forzadas, la API tiene un estado secundario de "forcible_disconnect"
- sub_status_failed_smtp_connectionTotal de conexiones SMTP fallidas, la API tiene un estado secundario de "failure_smtp_connection"
- fecha de inicioStart date of query. (format: yyyy/mm/dd)
- fecha finalEnd date of query. (format: yyyy/mm/dd)
Obtenga ejemplos de código de uso de API
'Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
' https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net
Tratar
Oscuro api_key COMO Cuerda = "Tu llave secreta"
Oscuro start_date COMO Cuerda = "2018-01-01"
Oscuro end_date COMO Cuerda = "2019-12-12"
Oscuro responseString COMO Cuerda = ""
Oscuro apiURL COMO Cuerda = "https://api.zerobounce.net/v2/getapiusage?api_key=" & api_key & "& start_date =" & start_date & "& end_date =" & end_date
Oscuro request COMO HttpWebRequest = Difusión directa(WebRequest.Create(apiURL), HttpWebRequest)
request.Se acabó el tiempo = 150000
request.Method = "OBTENER"
Utilizando response COMO WebResponse = request.GetResponse()
response.GetResponseStream().ReadTimeout = 20000
Utilizando ostream COMO NUEVO StreamReader(response.GetResponseStream())
responseString = ostream.ReadToEnd()
Fin Utilizando
Fin Utilizando
Captura ex COMO exception
'Excepción de captura: todos los errores se mostrarán aquí, si hay problemas con la API
Fin Tratar
// Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
// 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
Tratar {
Cuerda api_key = "Tu llave secreta";
Cuerda start_date = "2018-01-01";
Cuerda end_date = "2019-12-12";
Cuerda responseString = "";
Cuerda apiURL = "https://api.zerobounce.net/v2/getapiusage?api_key=" + api_key + "& start_date =" + start_date + "& end_date =" + end_date;
Httpwebrequest request = (HttpWebRequest)WebRequest.crear(apiURL);
request.Timeout = 150000;
request.Method = "OBTENER";
Utilizando (Respuesta web response = request.Obtener una respuesta()) {
response.Getresponsestream().ReadTimeout = 20000;
Utilizando (Lector de corriente ostream = NUEVO Lector de corriente(response.Getresponsestream())) {
responseString = ostream.Readtoend();
}
}
} Captura (exception ex) {
// Excepción de captura: todos los errores se mostrarán aquí, si hay problemas con la API
}
<?php
// Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
// https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php
// establece la clave de la api y el correo electrónico para validar
$ api_key = 'Tu clave secreta';
$ start_date = '2018-01-01';
$ end_date = '2019-12-12';
// usa curl para hacer la solicitud
$ 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 y superior tiene soporte para TLS 1.2
curl_setopt($ ch, CURLOPT_SSLVERSION, 6);
curl_setopt($ ch, CURLOPT_RETURNTRANSFER, Cierto);
curl_setopt($ ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ ch, CURLOPT_TIMEOUT, 150);
$ respuesta = curl_exec($ ch);
curl_close($ ch);
// decodifica la respuesta json
$ json = json_decode($ respuesta, Cierto);
?>
// Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
//https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java
importar Java.io.Lector tamponado;
importar Java.io.Inputstreamreader;
importar Java.red.Httpurlconnection;
importar Java.red.URL;
Público Clase Mi clase {
Público estático vacío principal(Cuerda[] args){
Cuerda key = "Tu llave secreta";
Cuerda start_date = "2018-01-01";
Cuerda end_date = "2019-12-12";
Cuerda targetURL = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& start_date ="+start_date+"& end_date ="+end_date;
Httpurlconnection connection = nulo;
final Cuerda USER_AGENT = "Mozilla / 5.0";
Tratar {
url url = NUEVO url(targetURL);
connection = (Httpurlconnection) url.conexión abierta();
connection.setrequestmethod("OBTENER");
connection.addrequestproperty("Agente de usuario", USER_AGENT);
connection.setusecaches(Falso);
connection.setdooutput(Cierto);
Lector tamponado in = NUEVO Lector tamponado(
NUEVO Inputstreamreader(connection.getinputstream()));
Cuerda inputLine;
Stringbuffer response = NUEVO Stringbuffer();
mientras ((inputLine = in.readline()) != nulo) {
response.adjuntar(inputLine);
}
in.cerrar();
// imprimir resultado
Sistema.out.println(response.toString());
} Captura (Excepción e) {
e.printstacktrace();
} finalmente {
Si (connection != nulo) {
connection.desconectar();
}
}
}
}
# Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
# https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
url = "https://api.zerobounce.net/v2/getapiusage"
api_key = "Tu llave secreta"
start_date = "2018-01-01"
end_date = "2019-12-12"
params = {"clave api": api_key, "fecha de inicio": start_date, "fecha final":end_date}
response = requests.get(url, params=params)
# Imprime el json devuelto
impresión json.loads(response.content)
// Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
// https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS
dejar key = "Tu llave secreta"
dejar start_date = "2018-01-01"
dejar end_date = "2019-12-12" // la dirección ip puede estar en blanco
dejar url = url(string: Cuerda(format: "https://api.zerobounce.net/v2/getapiusage?api_key=%@&start_date=%@&end_date=%@", key, start_date, end_date))
dejar task = Sesión.shared.tarea de datos(with: url!) { (data, response, error) en
Si error != nulo {
Nslog("Error (Cadena (que describe: error))")
} más {
hacer {
dejar parsedData = Tratar JSONSerialización.jsonobject(with: data!) COMO! [Cuerda:Alguna]
para (key, value) en parsedData {
Nslog("(clave) = (valor)")
}
} Captura {
impresión("Error al deserializar JSON: (error)")
}
}
}
task.currículum()
// Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
// https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS
NSString *key = @ "Tu clave secreta";
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;
Si(response!=nil)
{
arrResponse = [NSJSONSerialization JSONObjectWithData: response options:kNilOptions error:nil];
}
dispatch_async(dispatch_get_main_queue(), ^(vacío) {
para(NSString *key en [arrResponse allKeys]) {
Nslog(@"%@: %@",key,[arrResponse objectForKey:key]);
}
// devolución de llamada (nil, arr);
});
});
// Las bibliotecas y envoltorios API completos se pueden encontrar aquí:
// https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android
// Añadir a build.gradle (aplicación) en el soporte "android":
useLibrary 'org.apache.http.legacy'
Ejemplo:
android {
compileSdkVersion 25
useLibrary 'org.apache.http.legacy'
}
//-----------------------------------
// Nombre de archivo: JsonParser.java
importar androide.os.Asynctask;
importar org.json.jsonobject;
importar Java.util.Iterador;
Público Clase Actividad principal se extiende Appcompatactivity {
@Anular
protegido vacío crear(Haz savedInstanceState) {
súper.crear(savedInstanceState);
NUEVO Asynctaskparsejson().ejecutar();
}
}
Público Clase Asynctaskparsejson se extiende Asynctask<Cuerda, Cuerda, Cuerda> {
Cuerda key = "Tu llave secreta";
Cuerda start_date = "2018-01-01";
Cuerda end_date = "2019-12-12";
Cuerda url = "https://api.zerobounce.net/v2/getapiusage?api_key="+key+"& start_date ="+start_date+"& end_date ="+end_date;
@Anular
protegido vacío onpreexecute() {
}
@Anular
protegido Cuerda Doinbackground(Cuerda... arg0) {
Jsonparser jParser = NUEVO Jsonparser();
jsonobject json = jParser.getjsonfromurl(url);
Iterador keys = json.llaves();
mientras( keys.hasnext() ) {
Cuerda key = (Cuerda)keys.próximo();
Tratar {
Sistema.out.println("ZeroBounce:"+key+" = " +json.obtener(key).toString());
}
Captura (Excepción e){}
}
Regreso nulo;
}
@Anular
protegido vacío onpostexecute(Cuerda strFromDoInBg) {}
}
//----------------------------------
// Nombre de archivo: MainActivity.java
paquete com.Cero rebote.zbapiandroid;
importar Java.io.Lector tamponado;
importar Java.io.Ioexception;
importar Java.io.Flujo de entrada;
importar Java.io.Inputstreamreader;
importar Java.io.Excepción de notificación sin soporte;
importar org.apache.http.Httpentity;
importar org.apache.http.Httpresponse;
importar org.apache.http.cliente.Clienteprotocolexcepción;
importar org.apache.http.cliente.métodos.Httpget;
importar org.apache.http.impl.cliente.Cliente predeterminado;
importar org.json.Jsonexception;
importar org.json.jsonobject;
importar androide.util.Iniciar sesión;
Público Clase Jsonparser {
final Cuerda TAG = "jsonparser.java";
estático Flujo de entrada is = nulo;
estático jsonobject jObj = nulo;
estático Cuerda json = "";
Público jsonobject getjsonfromurl(Cuerda url) {
Tratar {
Cliente predeterminado httpClient = NUEVO Cliente predeterminado();
Httpget httpGet = NUEVO Httpget(url);
Httpresponse httpResponse = httpClient.ejecutar(httpGet);
Httpentity httpEntity = httpResponse.gentileza();
is = httpEntity.obtener el contenido();
} Captura (Excepción de notificación sin soporte e) {
e.printstacktrace();
} Captura (Clienteprotocolexcepción e) {
e.printstacktrace();
} Captura (Ioexception e) {
e.printstacktrace();
}
Tratar {
Lector tamponado reader = NUEVO Lector tamponado(NUEVO Inputstreamreader(is, "iso- 8859-1"), 8);
Constructor de cuerdas sb = NUEVO Constructor de cuerdas();
Cuerda line = nulo;
mientras ((line = reader.readline()) != nulo) {
sb.adjuntar(line + "
");
}
is.cerrar();
json = sb.toString();
} Captura (Excepción e) {
Iniciar sesión.e(TAG, "Error al convertir el resultado" + e.toString());
}
Tratar {
jObj = NUEVO jsonobject(json);
} Captura (Jsonexception e) {
Iniciar sesión.e(TAG, "Error al analizar datos" + e.toString());
}
Regreso jObj;
}
}
Respuesta de punto final
Respuesta exitosa
{
"total": 3,
"status_valid": 1,
"status_invalid": 2,
"status_catch_all": 0,
"status_do_not_mail": 0,
"status_spamtrap": 0,
"estado desconocido": 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,
"fecha de inicio": "1/1/2018",
"fecha final": "12/12/2019"
}
Respuesta de error - Clave API
{"error":"Clave API no válida"}
Respuesta de error - Fecha
{"error":"Fecha invalida"}