Getting Started

Prerequisites

Running the Service

docker compose up --build

The service is available at https://pdfcreator.tools.systaro.de.

Your First PDF

curl -X POST https://pdfcreator.tools.systaro.de/render \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Hello World</h1><p>This is a PDF.</p>"
  }' \
  --output hello.pdf

With a Stylesheet

Styles can be inlined in the HTML or loaded from any public URL.

{
  "html": "<link href='https://fonts.googleapis.com/css2?family=Inter' rel='stylesheet'><body style='font-family: Inter, sans-serif'><h1>Styled PDF</h1></body>"
}

With a Local Asset

Send assets as base64 strings and reference them with the asset:// scheme.

LOGO=$(base64 -i logo.png)

curl -X POST https://pdfcreator.tools.systaro.de/render \
  -H "Content-Type: application/json" \
  -d "{
    \"html\": \"<img src='asset://logo.png'><h1>With Logo</h1>\",
    \"assets\": { \"logo.png\": \"$LOGO\" }
  }" \
  --output with-logo.pdf

PDF/A Output

{
  "html": "<h1>Archival Document</h1>",
  "options": {
    "pdf_variant": "pdf/a-3b"
  }
}

Checking Service Health

curl https://pdfcreator.tools.systaro.de/health
# { "status": "ok" }