Estado del archivo (v2)

La API de estado de archivos devuelve el estado de procesamiento del archivo enviado mediante la API sendfile. Consulte el ejemplo de C # para más detalles.

GET / v2 / filestatus

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

Parámetros URL

  • Parámetro
    Descripción
  • clave api
    Su clave API, que se encuentra en su cuenta.
  • file_id
    El ID de archivo devuelto al llamar a la API sendfile.

If you want to call the API from your browser to test it, all you have to do is to replace the API KEY with your key and the FILE ID with the returned file ID from sendfile API:

https://bulkapi.zerobounce.net/v2/filestatus?api_key=[replacewithyours]&file_id=[replacewithyours]

Muestras de código de estado de archivo

  • 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

'Muestra de estado de archivo en VB.net

Público Clase FileStatus
    Público PROPIEDAD success COMO Booleano
    Público PROPIEDAD file_id COMO Cuerda
    Público PROPIEDAD file_name COMO Cuerda
    Público PROPIEDAD upload_date COMO Cuerda
    Público PROPIEDAD file_status COMO Cuerda
    Público PROPIEDAD complete_percentage COMO Cuerda
    Público PROPIEDAD return_url COMO Cuerda
Fin Clase

Privado Compartido SUB FileStatusAPITest()
    Oscuro apiKey COMO Cuerda = "reemplace con su clave de api aquí"
    Oscuro fileID COMO Cuerda = "reemplazar con el ID de archivo devuelto al llamar a la API sendfile"

    Tratar
        Oscuro fileStatus COMO FileStatus = FileStatusAsync(apiKey, fileID).Result
        Console.Escribir(JsonConvert.SerializeObject(fileStatus, Formatting.Indented))
    Captura ex COMO Exception
        Console.Escribir(ex.InnerException.Message)
    Fin Tratar

    Console.ReadKey()
Fin SUB

Público Compartido Async Función FileStatusAsync(Byval apiKey COMO Cuerda, Byval fileID COMO Cuerda) COMO Task(De FileStatus)
    Si Cuerda.IsNullOrEmpty(apiKey) Entonces Lanzar NUEVO Exception("Error: se requiere apiKey")
    Si Cuerda.IsNullOrEmpty(fileID) Entonces Lanzar NUEVO Exception("Error: se requiere ID de archivo")
    Oscuro uri COMO Uri = NUEVO Uri($"https://bulkapi.zerobounce.net/v2/filestatus?api_key={apiKey}&file_id={fileID}")

    Utilizando client = NUEVO HttpClient()
        Utilizando request = NUEVO HttpRequestMessage(HttpMethod.obtener, uri)
            Utilizando response = Await client.SendAsync(request).ConfigureAwait(Falso)
                Oscuro content = Await response.Content.ReadAsStringAsync()

                Si response.IsSuccessStatusCode = Falso Entonces
                    Oscuro error COMO Cuerda = $"StatusCode = {Cinturones(response.StatusCode)}, Content = {content}"
                    Lanzar NUEVO Exception(error)
                Fin Si

                Regreso JsonConvert.DeserializeObject(De FileStatus)(content)
            Fin Utilizando
        Fin Utilizando
    Fin Utilizando
Fin Función
    

// 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

// Muestra de estado de archivo en C #

Público Clase Estado de los archivos
{
    Público bool success { obtener; conjunto; }
    Público Cuerda file_id { obtener; conjunto; }
    Público Cuerda file_name { obtener; conjunto; }
    Público Cuerda upload_date { obtener; conjunto; }
    Público Cuerda file_status { obtener; conjunto; }
    Público Cuerda complete_percentage { obtener; conjunto; }
    Público Cuerda return_url { obtener; conjunto; }
}

Privado estático vacío Filestatusapitest()
{
    Cuerda apiKey = "reemplace con su clave de api aquí";
    Cuerda fileID = "reemplazar con el ID de archivo devuelto al llamar a la API sendfile";

    Tratar
    {
        Estado de los archivos fileStatus = Filestatusasync(apiKey, fileID).Result;
        Console.Escribir(JsonConvert.Serializeobject(fileStatus, Formatting.Indented));
    }
    Captura (Excepción ex)
    {
        Console.Escribir(ex.InnerException.Message);
    }
    Console.Leer la clave();
}

Público estático asíncrono Task<FileStatus> Filestatusasync(Cuerda apiKey, Cuerda fileID)
{
    Si (Cuerda.Isnullorempty(apiKey))
        Lanzar NUEVO Excepción("Error: se requiere apiKey");
    Si (Cuerda.Isnullorempty(fileID))
        Lanzar NUEVO Excepción("Error: se requiere ID de archivo");

    Uri uri = NUEVO Uri($"https://bulkapi.zerobounce.net/v2/filestatus?api_key={apiKey}&file_id={fileID}");

    Utilizando (var client = NUEVO Httpclient())
    Utilizando (var request = NUEVO Httprequestmessage(HttpMethod.Get, uri))
    Utilizando (var response = esperar client.Sendasync(request).Configureawait(Falso))
    {
        var content = esperar response.Content.Readasstringasync();

        Si (response.IsSuccessStatusCode == Falso)
        {
            var error = $"StatusCode = {(int) response.StatusCode}, Content = {content}";
            Lanzar NUEVO Excepción(error);
        }

        Regreso JsonConvert.DeserializarObjeto<Estado de los archivos>(content);
    }
}
    

    <?php
    // Las bibliotecas y envoltorios API completos se pueden encontrar aquí: 
    // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php

    $ curl = curl_init();
    
    curl_setopt_array($ curl, formación(
      CURLOPT_URL => "https://bulkapi.zerobounce.net/v2/filestatus?api_key=replacewithyours&file_id=replacewithyours",
      CURLOPT_RETURNTRANSFER => Cierto,
      CURLOPT_ENCODING => "",
      CURLOPT_MAXREDIRS => 10,
      CURLOPT_TIMEOUT => 30,
      CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
      CURLOPT_CUSTOMREQUEST => "OBTENER",
      CURLOPT_POSTFIELDS => "",
      CURLOPT_HTTPHEADER => formación(
        "Ficha de cartero: 91504 cea-f92f- 46 b0- 97 a4- 338167072887",
        "control de caché: sin caché"
      ),
    ));
    
    $ respuesta = curl_exec($ curl);
    $ err = curl_error($ curl);
    
    curl_close($ curl);
    
    Si ($ err) {
      eco "Error de cURL #:" . $ err;
    } más {
      eco $ respuesta;
    }
    ?>
    


  // Las bibliotecas y envoltorios API completos se pueden encontrar aquí: 
  //https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java

    Okhttpclient client = NUEVO Okhttpclient();

    Solicitud request = NUEVO Solicitud.Constructor()
      .url("https://bulkapi.zerobounce.net/v2/filestatus?api_key=replacewithyours&file_id=replacewithyours")
      .obtener()
      .addheader("control de caché", "sin caché")
      .addheader("Ficha de cartero", "7 fffd7a4-b2fd- 4 e8b-ac85- 4099411 f27ce")
      .construir();
    
    Respuesta response = client.nueva llamada(request).ejecutar();
    

    # Las bibliotecas y envoltorios API completos se pueden encontrar aquí: 
    # https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
  
    
    importar http.client

    conn = http.client.HTTPConnection("bulkapi, zerobounce, net")
    
    payload = ""
    
    headers = {
        'control de caché': "sin caché",
        'Ficha de cartero': "caa917fe- 45 ce- 45 ae- 9456-2 b039b999dcb"
        }
    
    conn.request("OBTENER", "v2, estado de archivos", payload, headers)
    
    res = conn.getresponse()
    data = res.read()
    
    impresión(data.decode("utf- 8"))
    
    


  // Las bibliotecas y envoltorios API completos se pueden encontrar aquí: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS

    // Seleccione el lenguaje VB o C # para File Status Sampleimport Foundation

    dejar headers = [
      "control de caché": "sin caché",
      "Ficha de cartero": "4 f1b92e2- 034 f- 4 fa0- 94 d9-b097d768668a"
    ]
    
    dejar request = Nsmutableurlrequest(url: NSURL(string: "https://bulkapi.zerobounce.net/v2/filestatus?api_key=replacewithyours&file_id=replacewithyours")! COMO url,
                                            cachePolicy: .useProtocolCachePolicy,
                                        timeoutInterval: 10.0)
    request.httpMethod = "OBTENER"
    request.allHTTPHeaderFields = headers
    
    dejar session = Sesión.shared
    dejar dataTask = session.tarea de datos(with: request COMO Solicitud de url, completionHandler: { (data, response, error) -> vacío en
      Si (error != nulo) {
        impresión(error)
      } más {
        dejar httpResponse = response COMO? Httpurlresponse
        impresión(httpResponse)
      }
    })
    
    dataTask.currículum()
    


  // Las bibliotecas y envoltorios API completos se pueden encontrar aquí: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS


    #importar <Foundation/Foundation.h>

    NSDictionary *headers = @{ @ "control de caché": @ "sin caché",
                               @ "Cartero-Token": @"5e9c24ae-b577-4e33-8748-83f14e151ae9" };
    
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:@"https://bulkapi.zerobounce.net/v2/filestatus?api_key=replacewithyours&file_id=replacewithyours"]
                                                           cachePolicy:NSURLRequestUseProtocolCachePolicy
                                                       timeoutInterval:10.0];
    [request setHTTPMethod:@"OBTENER"];
    [request setAllHTTPHeaderFields:headers];
    
    NSURLSession *session = [NSURLSession sharedSession];
    NSURLSessionDataTask *dataTask = [session dataTaskWithRequest:request
                                                completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                                                    Si (error) {
                                                        Nslog(@"%@", error);
                                                    } más {
                                                        NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *) response;
                                                        Nslog(@"%@", httpResponse);
                                                    }
                                                }];
    [dataTask resume];
    



  // Las bibliotecas y envoltorios API completos se pueden encontrar aquí: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android
// N/A
    

Respuesta de punto final

Respuesta exitosa

      
{
  "éxito": Cierto,
  "file_id": "aaaaaaaa-zzzz-xxxx-aaaa- 5003727 fffff",
  "nombre del archivo": "Su nombre de archivo.csv",
  "fecha de carga": "10/20/2018 4:35: 58 PM",
  "file_status": "Completar",
  "porcentaje_completo": "100%",
  "return_url": "Su URL de retorno si se proporciona al llamar a la API sendfile"
}
    

Respuesta de error


    {      
      "éxito": Falso,
      "mensaje": "Error de mensajes"
    }