Add Page Numbers API — numbered, professional PDFs

curl -X POST https://www.ashdocs.com/api/v1/tools/page-numbers \
  -H "X-API-Key: ash_live_..." \
  -F "files=@report.pdf" \
  -F 'options={"position":"bottom-center"}'

import requests

r = requests.post(
    "https://www.ashdocs.com/api/v1/tools/page-numbers",
    headers={"X-API-Key": "ash_live_..."},
    files=[("files", open("report.pdf", "rb"))],
    data={"options": '{"position":"bottom-center"}'},
)
job = r.json()
print(job["status"], job["output_files"][0]["url"])

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("files", new Blob([await readFile("report.pdf")]), "report.pdf");
form.append("options", JSON.stringify({"position":"bottom-center"}));

const res = await fetch("https://www.ashdocs.com/api/v1/tools/page-numbers", {
  method: "POST",
  headers: { "X-API-Key": "ash_live_..." },
  body: form,
});
const job = await res.json();
console.log(job.status, job.output_files[0].url);

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "ash_live_...");

using var form = new MultipartFormDataContent();
form.Add(new ByteArrayContent(await File.ReadAllBytesAsync("report.pdf")), "files", "report.pdf");
form.Add(new StringContent("{\"position\":\"bottom-center\"}"), "options");

var res = await client.PostAsync("https://www.ashdocs.com/api/v1/tools/page-numbers", form);
var job = await res.Content.ReadAsStringAsync();
Console.WriteLine(job);

import java.io.ByteArrayOutputStream;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

public class Sample {
  static final String BOUNDARY = "AshdocsBoundary7MA4YWxkTrZu0gW";

  public static void main(String[] args) throws Exception {
    ByteArrayOutputStream body = new ByteArrayOutputStream();
    addFile(body, "files", "report.pdf");
    addField(body, "options", "{\"position\":\"bottom-center\"}");
    body.write(("--" + BOUNDARY + "--\r\n").getBytes(StandardCharsets.UTF_8));

    HttpRequest req = HttpRequest.newBuilder(URI.create("https://www.ashdocs.com/api/v1/tools/page-numbers"))
        .header("X-API-Key", "ash_live_...")
        .header("Content-Type", "multipart/form-data; boundary=" + BOUNDARY)
        .POST(HttpRequest.BodyPublishers.ofByteArray(body.toByteArray()))
        .build();
    HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
    System.out.println(res.body());
  }

  static void addFile(ByteArrayOutputStream body, String name, String path) throws Exception {
    body.write(("--" + BOUNDARY + "\r\nContent-Disposition: form-data; name=\"" + name + "\"; filename=\""
        + Path.of(path).getFileName() + "\"\r\nContent-Type: application/octet-stream\r\n\r\n").getBytes(StandardCharsets.UTF_8));
    body.write(Files.readAllBytes(Path.of(path)));
    body.write("\r\n".getBytes(StandardCharsets.UTF_8));
  }

  static void addField(ByteArrayOutputStream body, String name, String value) throws Exception {
    body.write(("--" + BOUNDARY + "\r\nContent-Disposition: form-data; name=\"" + name + "\"\r\n\r\n"
        + value + "\r\n").getBytes(StandardCharsets.UTF_8));
  }
}

#include <stdio.h>
#include <curl/curl.h>

int main(void) {
  CURL *curl = curl_easy_init();
  if (!curl) return 1;
  struct curl_slist *headers = NULL;
  headers = curl_slist_append(headers, "X-API-Key: ash_live_...");
  curl_mime *mime = curl_mime_init(curl);
  curl_mimepart *part;
  part = curl_mime_addpart(mime);
  curl_mime_name(part, "files");
  curl_mime_filedata(part, "report.pdf");
  part = curl_mime_addpart(mime);
  curl_mime_name(part, "options");
  curl_mime_data(part, "{\"position\":\"bottom-center\"}", CURL_ZERO_TERMINATED);
  curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime);
  curl_easy_setopt(curl, CURLOPT_URL, "https://www.ashdocs.com/api/v1/tools/page-numbers");
  curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
  CURLcode rc = curl_easy_perform(curl);
  printf("\n");
  curl_mime_free(mime);
  curl_slist_free_all(headers);
  curl_easy_cleanup(curl);
  return rc == CURLE_OK ? 0 : 1;
}