ConvertoAPI pdf generator

A Fastify service that converts HTML or a URL into a PDF using Playwright/Chromium.

Documentation

• Developer guide — architecture, local setup, scripts, testing, CI/CD, and the release flow.
• Server configuration — environment variables, rate limiting, Chromium sandbox, and deployment.
• Docker — building, running, and the published image tags.

Quick start

pnpm install
pnpm exec playwright install --with-deps chromium
cp .env.template .env   # then fill in the values
pnpm dev

To run it with Docker instead, see docs/docker.md.

Usage

Get a token

The /token endpoint uses client_secret_basic authentication: send the client_id and client_secret as HTTP Basic credentials, with grant_type=client_credentials in the body. You get back a 1-hour JWT.

curl --request POST \
  --url http://localhost:3100/token \
  --header "Authorization: Basic $(echo -n 'client_id:client_secret' | base64)" \
  --header "Content-Type: application/json" \
  --data '{
    "grant_type": "client_credentials"
  }'

Generate a PDF

Use the token you received in the previous step to generate a PDF.

curl --request POST \
  --url http://localhost:3100/v1/pdf \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {TOKEN_HERE}' \
  --data '{
    "url": "https://www.google.com"
  }' \
  --output generated.pdf

Acknowledgements

• This project uses Fastify
• The PDF generation is done with Playwright
• The pdf controller is based on the work done in losol/converto