PDFCLOUD-4227 Add samples for the unzip route

DotNET/Endpoint Examples/JSON Payload/unzip.cs

@@ -0,0 +1,50 @@
+
+using Newtonsoft.Json.Linq;
+using System.Text;
+
+using (var httpClient = new HttpClient { BaseAddress = new Uri("https://api.pdfrest.com") })
+{
+    using (var uploadRequest = new HttpRequestMessage(HttpMethod.Post, "upload"))
+    {
+        uploadRequest.Headers.TryAddWithoutValidation("Api-Key", "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
+        uploadRequest.Headers.Accept.Add(new("application/json"));
+
+        var uploadByteArray = File.ReadAllBytes("/path/to/file");
+        var uploadByteAryContent = new ByteArrayContent(uploadByteArray);
+        uploadByteAryContent.Headers.TryAddWithoutValidation("Content-Type", "application/octet-stream");
+        uploadByteAryContent.Headers.TryAddWithoutValidation("Content-Filename", "filename.zip");
+
+
+        uploadRequest.Content = uploadByteAryContent;
+        var uploadResponse = await httpClient.SendAsync(uploadRequest);
+
+        var uploadResult = await uploadResponse.Content.ReadAsStringAsync();
+
+        Console.WriteLine("Upload response received.");
+        Console.WriteLine(uploadResult);
+
+        JObject uploadResultJson = JObject.Parse(uploadResult);
+        var uploadedID = uploadResultJson["files"][0]["id"];
+        using (var unzipRequest = new HttpRequestMessage(HttpMethod.Post, "unzip"))
+        {
+            unzipRequest.Headers.TryAddWithoutValidation("Api-Key", "xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
+            unzipRequest.Headers.Accept.Add(new("application/json"));
+
+            unzipRequest.Headers.TryAddWithoutValidation("Content-Type", "application/json");
+
+
+            JObject parameterJson = new JObject
+            {
+                ["id"] = uploadedID,
+            };
+
+            unzipRequest.Content = new StringContent(parameterJson.ToString(), Encoding.UTF8, "application/json"); ;
+            var unzipResponse = await httpClient.SendAsync(unzipRequest);
+
+            var unzipResult = await unzipResponse.Content.ReadAsStringAsync();
+
+            Console.WriteLine("Processing response received.");
+            Console.WriteLine(unzipResult);
+        }
+    }
+}

DotNET/Endpoint Examples/Multipart Payload/unzip.cs

@@ -0,0 +1,25 @@
+using System.Text;
+
+using (var httpClient = new HttpClient { BaseAddress = new Uri("https://api.pdfrest.com") })
+{
+    using (var request = new HttpRequestMessage(HttpMethod.Post, "unzip"))
+    {
+        request.Headers.TryAddWithoutValidation("Api-Key", "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
+        request.Headers.Accept.Add(new("application/json"));
+        var multipartContent = new MultipartFormDataContent();
+
+        var byteArray = File.ReadAllBytes("/path/to/file");
+        var byteAryContent = new ByteArrayContent(byteArray);
+        multipartContent.Add(byteAryContent, "file", "file_name");
+        byteAryContent.Headers.TryAddWithoutValidation("Content-Type", "application/pdf");
+
+
+        request.Content = multipartContent;
+        var response = await httpClient.SendAsync(request);
+
+        var apiResult = await response.Content.ReadAsStringAsync();
+
+        Console.WriteLine("API response received.");
+        Console.WriteLine(apiResult);
+    }
+}

Java/Endpoint Examples/JSON Payload/Unzip.java

@@ -0,0 +1,96 @@
+import io.github.cdimascio.dotenv.Dotenv;
+import java.io.File;
+import java.io.IOException;
+import java.util.concurrent.TimeUnit;
+import okhttp3.*;
+import org.json.JSONArray;
+import org.json.JSONObject;
+
+public class Unzip {
+
+  // Specify the path to your file here, or as the first argument when running the program.
+  private static final String DEFAULT_FILE_PATH = "/path/to/file.zip";
+
+  // Specify your API key here, or in the environment variable PDFREST_API_KEY.
+  // You can also put the environment variable in a .env file.
+  private static final String DEFAULT_API_KEY = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
+
+  public static void main(String[] args) {
+    File inputFile;
+    if (args.length > 0) {
+      inputFile = new File(args[0]);
+    } else {
+      inputFile = new File(DEFAULT_FILE_PATH);
+    }
+    final Dotenv dotenv = Dotenv.configure().ignoreIfMalformed().ignoreIfMissing().load();
+
+    String uploadString = uploadFile(inputFile);
+    JSONObject uploadJSON = new JSONObject(uploadString);
+    if (uploadJSON.has("error")) {
+      System.out.println("Error during upload: " + uploadString);
+      return;
+    }
+    JSONArray fileArray = uploadJSON.getJSONArray("files");
+
+    JSONObject fileObject = fileArray.getJSONObject(0);
+
+    String uploadedID = fileObject.get("id").toString();
+
+    String JSONString = String.format("{\"id\":\"%s\"}", uploadedID);
+
+    final RequestBody requestBody =
+        RequestBody.create(JSONString, MediaType.parse("application/json"));
+
+    Request request =
+        new Request.Builder()
+            .header("Api-Key", dotenv.get("PDFREST_API_KEY", DEFAULT_API_KEY))
+            .url("https://api.pdfrest.com/unzip")
+            .post(requestBody)
+            .build();
+    try {
+      OkHttpClient client =
+          new OkHttpClient().newBuilder().readTimeout(60, TimeUnit.SECONDS).build();
+
+      Response response = client.newCall(request).execute();
+      System.out.println("Processing Result code " + response.code());
+      if (response.body() != null) {
+        System.out.println(prettyJson(response.body().string()));
+      }
+    } catch (IOException e) {
+      throw new RuntimeException(e);
+    }
+  }
+
+  private static String prettyJson(String json) {
+    // https://stackoverflow.com/a/9583835/11996393
+    return new JSONObject(json).toString(4);
+  }
+
+  // This function is just a copy of the 'Upload.java' file to upload a binary file
+  private static String uploadFile(File inputFile) {
+
+    final Dotenv dotenv = Dotenv.configure().ignoreIfMalformed().ignoreIfMissing().load();
+
+    final RequestBody requestBody =
+        RequestBody.create(inputFile, MediaType.parse("application/pdf"));
+
+    Request request =
+        new Request.Builder()
+            .header("Api-Key", dotenv.get("PDFREST_API_KEY", DEFAULT_API_KEY))
+            .header("Content-Filename", "File.zip")
+            .url("https://api.pdfrest.com/upload")
+            .post(requestBody)
+            .build();
+    try {
+      OkHttpClient client = new OkHttpClient().newBuilder().build();
+      Response response = client.newCall(request).execute();
+      System.out.println("Upload Result code " + response.code());
+      if (response.body() != null) {
+        return response.body().string();
+      }
+    } catch (IOException e) {
+      throw new RuntimeException(e);
+    }
+    return "";
+  }
+}

Java/Endpoint Examples/Multipart Payload/Unzip.java

@@ -0,0 +1,58 @@
+import io.github.cdimascio.dotenv.Dotenv;
+import java.io.File;
+import java.io.IOException;
+import java.util.concurrent.TimeUnit;
+import okhttp3.*;
+import org.json.JSONObject;
+
+public class Unzip {
+
+  // Specify the path to your file here, or as the first argument when running the program.
+  private static final String DEFAULT_FILE_PATH = "/path/to/file.zip";
+
+  // Specify your API key here, or in the environment variable PDFREST_API_KEY.
+  // You can also put the environment variable in a .env file.
+  private static final String DEFAULT_API_KEY = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
+
+  public static void main(String[] args) {
+    File inputFile;
+    if (args.length > 0) {
+      inputFile = new File(args[0]);
+    } else {
+      inputFile = new File(DEFAULT_FILE_PATH);
+    }
+
+    final Dotenv dotenv = Dotenv.configure().ignoreIfMalformed().ignoreIfMissing().load();
+
+    final RequestBody inputFileRequestBody =
+        RequestBody.create(inputFile, MediaType.parse("application/pdf"));
+    RequestBody requestBody =
+        new MultipartBody.Builder()
+            .setType(MultipartBody.FORM)
+            .addFormDataPart("file", inputFile.getName(), inputFileRequestBody)
+            .build();
+    Request request =
+        new Request.Builder()
+            .header("Api-Key", dotenv.get("PDFREST_API_KEY", DEFAULT_API_KEY))
+            .url("https://api.pdfrest.com/unzip")
+            .post(requestBody)
+            .build();
+    try {
+      OkHttpClient client =
+          new OkHttpClient().newBuilder().readTimeout(60, TimeUnit.SECONDS).build();
+
+      Response response = client.newCall(request).execute();
+      System.out.println("Result code " + response.code());
+      if (response.body() != null) {
+        System.out.println(prettyJson(response.body().string()));
+      }
+    } catch (IOException e) {
+      throw new RuntimeException(e);
+    }
+  }
+
+  private static String prettyJson(String json) {
+    // https://stackoverflow.com/a/9583835/11996393
+    return new JSONObject(json).toString(4);
+  }
+}

JavaScript/Endpoint Examples/JSON Payload/unzip.js

@@ -0,0 +1,47 @@
+var axios = require("axios");
+var FormData = require("form-data");
+var fs = require("fs");
+
+var upload_data = fs.createReadStream("/path/to/file");
+
+var upload_config = {
+  method: "post",
+  maxBodyLength: Infinity,
+  url: "https://api.pdfrest.com/upload",
+  headers: {
+    "Api-Key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // Replace with your API key
+    "Content-Filename": "filename.zip",
+    "Content-Type": "application/octet-stream",
+  },
+  data: upload_data, // set the data to be sent with the request
+};
+
+// send request and handle response or error
+axios(upload_config)
+  .then(function (upload_response) {
+    console.log(JSON.stringify(upload_response.data));
+    var uploaded_id = upload_response.data.files[0].id;
+
+    var unzip_config = {
+      method: "post",
+      maxBodyLength: Infinity,
+      url: "https://api.pdfrest.com/unzip",
+      headers: {
+        "Api-Key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // Replace with your API key
+        "Content-Type": "application/json",
+      },
+      data: { id: uploaded_id }, // set the data to be sent with the request
+    };
+
+    // send request and handle response or error
+    axios(unzip_config)
+      .then(function (unzip_response) {
+        console.log(JSON.stringify(unzip_response.data));
+      })
+      .catch(function (error) {
+        console.log(error);
+      });
+  })
+  .catch(function (error) {
+    console.log(error);
+  });

JavaScript/Endpoint Examples/Multipart Payload/unzip.js

@@ -0,0 +1,33 @@
+/**
+ * This request demonstrates how to unzip a file
+ */
+var axios = require("axios");
+var FormData = require("form-data");
+var fs = require("fs");
+
+// Create a new form data instance and append the PDF file and parameters to it
+var data = new FormData();
+data.append("file", fs.createReadStream("/path/to/file"));
+
+// define configuration options for axios request
+var config = {
+  method: "post",
+  maxBodyLength: Infinity, // set maximum length of the request body
+  url: "https://api.pdfrest.com/unzip",
+  headers: {
+    "Api-Key": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // Replace with your API key
+    ...data.getHeaders(), // set headers for the request
+  },
+  data: data, // set the data to be sent with the request
+};
+
+// send request and handle response or error
+axios(config)
+  .then(function (response) {
+    console.log(JSON.stringify(response.data));
+  })
+  .catch(function (error) {
+    console.log(error);
+  });
+
+// If you would like to download the file instead of getting the JSON response, please see the 'get-resource-id-endpoint.js' sample.

PHP/Endpoint Examples/JSON Payload/unzip.php

@@ -0,0 +1,33 @@
+<?php
+require 'vendor/autoload.php'; // Require the autoload file to load Guzzle HTTP client.
+
+use GuzzleHttp\Client; // Import the Guzzle HTTP client namespace.
+use GuzzleHttp\Psr7\Request; // Import the PSR-7 Request class.
+use GuzzleHttp\Psr7\Utils; // Import the PSR-7 Utils class for working with streams.
+
+$upload_client = new Client(['http_errors' => false]);
+$upload_headers = [
+  'api-key' => 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  'content-filename' => 'filename.zip',
+  'Content-Type' => 'application/octet-stream'
+];
+$upload_body = file_get_contents('/path/to/file');
+$upload_request = new Request('POST', 'https://api.pdfrest.com/upload', $upload_headers, $upload_body);
+$upload_res = $upload_client->sendAsync($upload_request)->wait();
+echo $upload_res->getBody() . PHP_EOL;
+
+$upload_response_json = json_decode($upload_res->getBody());
+
+$uploaded_id = $upload_response_json->{'files'}[0]->{'id'};
+
+echo "Successfully uploaded with an id of: " . $uploaded_id . PHP_EOL;
+
+$unzip_client = new Client(['http_errors' => false]);
+$unzip_headers = [
+  'api-key' => 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+  'Content-Type' => 'application/json'
+];
+$unzip_body = '{"id":"'.$uploaded_id.'"}';
+$unzip_request = new Request('POST', 'https://api.pdfrest.com/unzip', $unzip_headers, $unzip_body);
+$unzip_res = $unzip_client->sendAsync($unzip_request)->wait();
+echo $unzip_res->getBody() . PHP_EOL;

PHP/Endpoint Examples/Multipart Payload/unzip.php

@@ -0,0 +1,31 @@
+<?php
+require 'vendor/autoload.php'; // Require the autoload file to load Guzzle HTTP client.
+
+use GuzzleHttp\Client; // Import the Guzzle HTTP client namespace.
+use GuzzleHttp\Psr7\Request; // Import the PSR-7 Request class.
+use GuzzleHttp\Psr7\Utils; // Import the PSR-7 Utils class for working with streams.
+
+$client = new Client(); // Create a new instance of the Guzzle HTTP client.
+
+$headers = [
+  'Api-Key' => 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' // Set the API key in the headers for authentication.
+];
+
+$options = [
+  'multipart' => [
+    [
+      'name' => 'file', // Specify the field name for the file.
+      'contents' => Utils::tryFopen('/path/to/file', 'r'), // Open the file specified by the '/path/to/file' for reading.
+      'filename' => 'file.zip', // Set the filename for the file to be processed, in this case, 'file.zip'.
+      'headers' => [
+        'Content-Type' => '<Content-type header>' // Set the Content-Type header for the file.
+      ]
+    ]
+  ]
+];
+
+$request = new Request('POST', 'https://api.pdfrest.com/unzip', $headers); // Create a new HTTP POST request with the API endpoint and headers.
+
+$res = $client->sendAsync($request, $options)->wait(); // Send the asynchronous request and wait for the response.
+
+echo $res->getBody(); // Output the response body, which contains the unzipped content.