Obtener uso de API (v2)

GET / v2 / getapiusage

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

Parámetros URL

  • Parámetro
    Descripción
  • clave api
    Su clave API, que se encuentra en su cuenta.
  • fecha de inicio
    The start date of when you want to view API usage. (format: yyyy/mm/dd)
  • fecha final
    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

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ámetro
    Descripción
  • Total
    Número total de veces que se ha llamado a la API
  • ESTADO_VÁLIDO
    Total de direcciones de correo electrónico válidas devueltas por la API
  • ESTADO_INVÁLIDO
    Total de direcciones de correo electrónico no válidas devueltas por la API
  • STATUS_CATCH_ALL
    Total de direcciones de correo electrónico generales devueltas por la API
  • STATUS_DO_NOT_MAIL
    Total de direcciones de correo electrónico no enviadas por la API
  • STATUS_SPAMTRAP
    Total de direcciones de correo electrónico de spam devueltas por la API
  • ESTADO DESCONOCIDO
    Total de direcciones de correo electrónico desconocidas devueltas por la API
  • sub_status_toxic
    Número total de veces que la API tiene un estado secundario de "tóxico"
  • sub_status_disposable
    Número total de veces que la API tiene un estado secundario de "desechable"
  • sub_status_role_based
    Número total de veces que la API tiene un sub estado de "role_based"
  • sub_status_possible_trap
    Número total de veces que la API tiene un estado secundario de "posible_trap"
  • sub_status_global_suppression
    Número total de veces que la API tiene un estado secundario de "global_suppression"
  • sub_status_timeout_exceeded
    Número total de veces que la API tiene un estado secundario de "timeout_exceeded"
  • sub_status_mail_server_temporary_error
    Número total de veces que la API tiene un subestado de "mail_server_temporary_error"
  • sub_status_mail_server_did_not_respond
    Número total de veces que la API tiene un estado secundario de "mail_server_did_not_respond"
  • sub_status_greylisted
    Número total de veces que la API tiene un estado secundario de "lista gris"
  • sub_status_antispam_system
    Número total de veces que la API tiene un estado secundario de "antispam_system"
  • sub_status_does_not_accept_mail
    Número total de veces que la API tiene un estado secundario de "does_not_accept_mail"
  • sub_status_exception_occurred
    Número total de veces que la API tiene un estado secundario de "excepción_currida"
  • sub_status_failed_syntax_check
    Número total de veces que la API tiene un estado secundario de "failure_syntax_check"
  • sub_status_mailbox_not_found
    Número total de veces que la API tiene un estado secundario de "buzón_no_encontrado"
  • sub_status_unroutable_ip_address
    Número total de veces que la API tiene un estado secundario de "unroutable_ip_address"
  • sub_status_possible_typo
    Número total de veces que la API tiene un estado secundario de "possible_typo"
  • sub_status_no_dns_entries
    Número total de veces que la API tiene un estado secundario de "no_dns_entries"
  • sub_status_role_based_catch_all
    Total basado en roles para capturar todos, la API tiene un estado secundario de "role_based_catch_all"
  • sub_status_mailbox_quota_exceeded
    Número total de veces que la API tiene un estado secundario de "buzón_cuota_excedida"
  • sub_status_forcible_disconnect
    Total de desconexiones forzadas, la API tiene un estado secundario de "forcible_disconnect"
  • sub_status_failed_smtp_connection
    Total de conexiones SMTP fallidas, la API tiene un estado secundario de "failure_smtp_connection"
  • fecha de inicio
    Start date of query. (format: yyyy/mm/dd)
  • fecha final
    End date of query. (format: yyyy/mm/dd)

Obtenga ejemplos de código de uso de API

  • Visual básico
  • C#
  • PHP
  • Java
  • Pitón
  • Rápido
  • C objetivo
  • Android java
      
'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"}