PDF Generation API v1 — Staatloos

API voor het genereren van PDF's
van zakelijke sjablonen

Genereer PDF's vanuit uw HTML-, DOCX-, Markdown- of JSON-sjablonen. Geen gegevensretentie – geen documenten of gegevens opgeslagen.

Ontvang uw API-sleutel Snelstartgids

4 invoerformaten

Variabele vervanging

Geen gegevensopslag

99,9% uptime-SLA

Snel beginnen

Ontvang uw eerste PDF in minder dan 2 minuten. Maak een API-sleutel, stuur een verzoek en download het resultaat.

Haal uw API-sleutel op

Maak een API-sleutel via de onderstaande console of vanaf uw dashboard.

Uw API-sleutel is geheim. Geef het nooit bloot in frontend-code.

Verstuur uw eerste aanvraag

Gebruik de volgende cURL-opdracht om een PDF te genereren:

Terminal

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<h1>Invoice #{{invoice_number}}</h1><p>Client: {{client_name}}</p><p>Amount: {{amount}}</p>",
    "variables": {
      "invoice_number": "2026-001",
      "client_name": "Acme Corp",
      "amount": "$1,250.00"
    }
  }' \
  --output invoice.pdf

Download uw PDF

De API retourneert het binaire PDF-bestand rechtstreeks in de antwoordtekst.

De gegenereerde PDF wordt opgeslagen in het bestand dat is opgegeven in de vlag --output.

Live-demo

Probeer de API hier: bewerk de inhoud en variabelen en klik vervolgens op Genereer om uw PDF direct te bekijken.

Log in om de demo te proberen

Maak een gratis account aan om toegang te krijgen tot de live speeltuin en om maximaal 5 demo-PDF's te genereren.

Account aanmaken Log in

API-console

Beheer uw API-sleutels en volg het gebruik rechtstreeks vanaf deze pagina.

Inloggen vereist

Meld u aan om uw API-sleutels te maken en te beheren.

Account aanmaken Log in

Authenticatie

Voor alle API-verzoeken is een API-sleutel vereist die via de X-API-Key-header wordt verzonden.

Hoe het werkt

Maak een API-sleutel vanaf de console of het dashboard.
Neem het in elk verzoek op als X-API-Key header.
De API valideert uw sleutel en controleert uw quotum.
Ongeldige of ingetrokken sleutels retourneren een 401-fout.

Houd uw API-sleutel veilig. Gebruik omgevingsvariabelen en codeer nooit in de broncode.

Voorbeeld verzoek

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: sk_live_abc123def456..." \
  -H "Content-Type: application/json" \
  -d '{"format":"html","content":"<h1>Hello</h1>"}' \
  --output output.pdf

Ongeldig sleutelantwoord (401)

{
  "error": "invalid_api_key",
  "message": "The provided API key is invalid."
}

Invoerformaten

EasyPDF ondersteunt 4 invoerformaten. Kies degene die het beste bij uw workflow past.

HTML

Volledige CSS-ondersteuning, pixel-perfect via Chromium

DOCX

Upload Word-sjablonen met variabele tijdelijke aanduidingen

Markdown

5 ingebouwde thema's voor prachtige documenten

Template JSON

Canvas-engine voor nauwkeurige lay-outcontrole

HTML → PDF

Meest populair

Verzend elke HTML met inline CSS. De Chromium-renderingengine zorgt voor pixel-perfecte uitvoer die overeenkomt met de browserweergave.

Belangrijkste kenmerken

Volledige CSS3-ondersteuning (Flexbox, Grid, mediaquery's)
Aangepaste kop- en voetteksten met paginanummers
Variabelevervanging met {{variable}}-syntaxis
Responsieve lay-outs met paginaformaten A4/Letter/Legal

Request body

{
  "format": "html",
  "content": "<html><head><style>body{font-family:Arial;padding:40px}h1{color:#333}.total{font-size:24px;font-weight:bold;color:#8b5cf6}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Date: {{date}}</p><p>Client: {{client_name}}</p><table><tr><th>Item</th><th>Price</th></tr><tr><td>{{item_1}}</td><td>{{price_1}}</td></tr></table><p class='total'>Total: {{total}}</p></body></html>",
  "variables": {
    "invoice_number": "2026-042",
    "date": "2026-03-16",
    "client_name": "Acme Corp",
    "item_1": "Web Development",
    "price_1": "$3,500",
    "total": "$4,700"
  },
  "options": { "page_format": "A4", "margin_top": "25mm" }
}

API-eindpunten

Base URL: ${API_URL}/api/v1

POST/generate/pdfAPI Key

Genereer een PDF van HTML-, Markdown- of Template-JSON-inhoud.

Request Body (JSON)

Parameter	Type	Vereist	Beschrijving
`format`	`string`	No	`"html"` (default), `"markdown"`, `"template"`
`content`	`string`	Yes*	HTML- of Markdown-inhoudsreeks (vereist voor html/markdown)
`template_data`	`object`	Yes*	Sjabloon JSON-object (vereist voor sjabloonindeling)
`variables`	`object`	No	Sleutel-waardeparen voor vervanging van variabelen
`options`	`object`	No	Opties voor het genereren van PDF's (paginaformaat, marges, enz.)

Antwoord

200Content-Type: application/pdf

4xx/5xxContent-Type: application/json

POST/generate/pdf/uploadAPI Key

Upload een DOCX-bestand voor conversie naar PDF met optionele vervanging van variabelen.

Form Fields

Field	Type	Vereist	Beschrijving
`file`	File	Yes	Het .docx-bestand dat moet worden geconverteerd
`variables`	string (JSON)	No	Sleutel-waardeparen voor vervanging van variabelen
`options`	string (JSON)	No	PDF-opties als JSON-tekenreeks

POST/generate/previewAPI Key

Genereer een PNG-voorbeeld van de eerste pagina in plaats van een volledige PDF.

200Content-Type: image/png

GET/usageAPI Key

Controleer uw huidige maandelijkse gebruik en resterende quotum.

Response (200)

{
  "month": "2026-03",
  "used": 142,
  "limit": 500,
  "remaining": 358,
  "plan": "starter"
}

POST/keysJWT Bearer

Maak een nieuwe API-sleutel (vereist JWT-authenticatie).

GET/keysJWT Bearer

Vermeld al uw API-sleutels met gebruiksstatistieken.

DELETE/keys/:key_idJWT Bearer

Een API-sleutel permanent intrekken (deactiveren).

Codevoorbeelden

Volledige, gebruiksklare voorbeelden in de taal en het formaat van uw voorkeur. Selecteer hieronder een taal en invoerformaat.

curl — HTML

curl -X POST ${API_URL}/api/v1/generate/pdf \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "html",
    "content": "<html><head><style>body{font-family:sans-serif;padding:40px}h1{color:#8b5cf6}table{width:100%;border-collapse:collapse}th,td{padding:8px 12px;border-bottom:1px solid #eee}</style></head><body><h1>Invoice #{{invoice_number}}</h1><p>Client: <strong>{{client_name}}</strong></p><table><tr><th>Item</th><th>Amount</th></tr><tr><td>{{line_1}}</td><td>{{amount_1}}</td></tr></table><h2>Total: {{total}}</h2></body></html>",
    "variables": {
      "invoice_number": "INV-2026-042",
      "client_name": "Acme Corp",
      "line_1": "Web Development",
      "amount_1": "$3,500.00",
      "total": "$4,700.00"
    },
    "options": { "page_format": "A4", "margin_top": "20mm" }
  }' --output invoice.pdf

Gebruiksscenario's

Bekijk hoe teams de EasyPDF API gebruiken om het genereren van documenten op grote schaal te automatiseren.

Facturen en ontvangstbewijzen

Genereer merkfacturen met dynamische regelitems, totalen en klantgegevens.

HTML / DOCX

Contracten & Overeenkomsten

Vul Word-sjablonen met klantgegevens en converteer naar PDF om te ondertekenen.

DOCX

Certificaten & Diploma's

Creëer gepersonaliseerde certificaten met nauwkeurige lay-out en positionering.

Template JSON

Rapporten en dashboards

Zet Markdown- of HTML-gegevens om in gepolijste PDF-rapporten.

Markdown / HTML

Brieven en mailings

Genereer gepersonaliseerde brieven op basis van DOCX-sjablonen voor bulkmailings.

DOCX

Nalevingsdocumenten

Produceer auditklare, fraudebestendige nalevingsdocumenten.

HTML

PDF-opties

Pas de uitvoer aan met deze optionele parameters in het optieobject.

Option	Type	Standaard	Beschrijving
`page_format`	`string`	`"A4"`	Paginaformaat: A4, Letter, Legal, Tabloid of aangepast
`landscape`	`boolean`	`false`	Schakel liggende oriëntatie in
`margin_top`	`string`	`"20mm"`	Bovenmarge (CSS-eenheden: mm, cm, in, px)
`margin_bottom`	`string`	`"20mm"`	Onderste marge
`margin_left`	`string`	`"15mm"`	Linkermarge
`margin_right`	`string`	`"15mm"`	Rechter marge
`header_html`	`string`	`null`	HTML-inhoud voor paginakop
`footer_html`	`string`	`null`	HTML-inhoud voor paginavoettekst (ondersteunt pageNumber, totalPages)
`theme`	`string`	`"modern"`	Markdown-thema: modern, klassiek, minimaal, github, academisch

Voorbeeld van volledige opties

JSON

{
  "format": "html",
  "content": "<h1>Report</h1><p>Content here...</p>",
  "variables": {},
  "options": {
    "page_format": "A4",
    "landscape": false,
    "margin_top": "25mm",
    "margin_bottom": "25mm",
    "margin_left": "20mm",
    "margin_right": "20mm",
    "header_html": "<div style='text-align:right;font-size:9px'>Acme Corp — Confidential</div>",
    "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> / <span class='totalPages'></span></div>",
    "theme": "modern"
  }
}

Foutafhandeling

De API retourneert gestructureerde JSON-fouten met consistente foutcodes.

Formaat voor foutreactie

{
  "error": "missing_content",
  "message": "The 'content' field is required for html format."
}

HTTP	Error	Wanneer	Wat te doen
`400`	`missing_content`	Verplicht veld ontbreekt	Controleer de hoofdtekstvelden van het verzoek
`400`	`invalid_json`	JSON-parseren is mislukt	Valideer uw JSON-payload
`400`	`unsupported_format`	Onbekende formaatwaarde	Gebruik html, markdown of sjabloon
`401`	`invalid_api_key`	API-sleutel niet gevonden	Controleer uw X-API-Key-header
`402`	`quota_exceeded`	Maandelijks quotum overschreden	Upgrade uw abonnement of wacht op een reset
`403`	`api_key_revoked`	Sleutel is ingetrokken	Maak een nieuwe API-sleutel
`429`	`rate_limit_exceeded`	Tarieflimiet bereikt	Wacht en probeer het opnieuw met exponentieel uitstel
`500`	`generation_failed`	Interne verwerkingsfout	Controleer uw inhoud op fouten en probeer het opnieuw

Tarieflimieten en quota's

Elk abonnement heeft een maandelijks PDF-quotum en een tarieflimiet per minuut.

Tariefbeperking

Verzoeken die uw tarieflimiet overschrijden, ontvangen een 429-antwoord met een Retry-After-header.

Rate-beperkte respons

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

Maandelijkse quota

Het gebruik wordt opnieuw ingesteld op de 1e van elke maand om middernacht UTC.

Plan	PDFs/maand	Rate limit	Prijs	Overmaat
Starter	500	10/min	9€/maand	0,02€/PDF
Business	5 000	30/min	79€/maand	0,01€/PDF
Enterprise	Aangepast	Aangepast	Op offerte	Bespreekbaar

Beste praktijken

Volg deze aanbevelingen om het maximale uit de API te halen.

Gebruik variabelen voor dynamische inhoud

Houd uw sjablonen statisch en injecteer gegevens via het variabelenobject. Dit is efficiënter dan het opnieuw opbouwen van HTML bij elke aanroep.

Ga netjes met fouten om

Controleer altijd de HTTP-statuscode. Implementeer nieuwe pogingen met exponentiële uitstel voor 429- en 5xx-fouten.

Optimaliseer uw sjablonen

Minimaliseer CSS, vermijd externe middelen (inline) en test sjablonen voordat u ze in productie neemt.

Houd uw verbruik in de gaten

Gebruik het /usage-eindpunt of de console hierboven om het verbruik bij te houden en onverwachte quotumlimieten te vermijden.

Beveilig uw API-sleutels

Bewaar sleutels in omgevingsvariabelen of geheime managers. Roteer sleutels periodiek en trek ongebruikte sleutels in.

Prijzen

Eenvoudige, transparante prijzen. Betaal alleen voor wat u gebruikt.

Starter

9€/maand

~0,018€ / PDF

500 PDFs / maand
10 aanvragen/min
Alle 4 invoerformaten
Generatie van PNG-voorbeelden
E-mailondersteuning
Overmaat : 0,02€/PDF

Aan de slag

Beste waarde

Business

79€/maand

~0,016€ / PDF

5 000 PDFs / maand
30 aanvragen/min
Alle starterfuncties
Prioritaire ondersteuning
Dashboard voor gebruiksanalyse
Overmaat : 0,01€/PDF