API reference

Base URL https://pdfgen.arsi.in. Authenticate with your project's API key as a bearer token. Machine-readable spec: /v1/openapi.json.

Render a PDF

POST /v1/pdf returns the PDF bytes directly.

curl -X POST https://pdfgen.arsi.in/v1/pdf \
  -H "Authorization: Bearer pk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/invoice/42", "pdf": {"format": "a4"}}' \
  -o invoice.pdf

Request body

Async rendering & callbacks

Add callback_url and the API responds 202 with a job. When the PDF is ready we POST it to your URL as application/pdf (or a JSON pdf.failed event). Poll GET /v1/jobs/:id any time for status and a signed download link.

import crypto from "node:crypto";

// X-PDFGen-Signature: t=<unix seconds>,v1=<hex hmac>
export function verify(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = crypto
    .createHmac("sha256", secret)
    .update(Buffer.concat([Buffer.from(`${t}.`), rawBody]))
    .digest("hex");
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

Reliability features

• Idempotency-Key header: retries return the original result without rendering or charging again.
• Prefer: respond-async: on temporary overload, get a 202 job instead of a 503.
• Failed renders are never charged; your quota is released automatically.

Errors

Errors use application/problem+json with a stable code.