gPdf render/edge
Use cases · PDF-generatie-API

PDF-generatie-API voor dynamische bedrijfsdocumenten

Zoek je een PDF-generator? gPdf is een JSON-to-PDF API voor teams die dynamische en batchgewijze PDFs rechtstreeks uit systemen genereren.

Job to be done

Bedrijfsdata automatisch omzetten naar productieklare PDFs: verzendlabels, facturen, rapporten, certificaten en klantdocumenten worden vanuit JSON in je applicatie gegenereerd, zonder handmatige uploads of losse exports.

Why gPdf for this

  • JSON-to-PDF-generatie: beschrijf pagina's, tekst, afbeeldingen, tabellen, barcodes en metadata in één gestructureerde DocumentRequest.
  • API-first workflow: roep POST /api/v1/pdf/render aan vanuit je backend, job queue, magazijnsysteem of SaaS-product.
  • Geschikt voor batchvolume: genereer duizenden of miljoenen PDFs zonder een headless-browsercluster te beheren.
  • Ingebouwde fonts voor Latin, CJK, Arabisch, Devanagari, Bengaals, Thai en Cyrillisch.
  • Vectorbarcodes en vaste labelformaten voor logistiek, ecommerce en voorraaddocumenten.
  • PDF/A, metadata en e-invoice-opties wanneer documenten archivering, auditbaarheid of compliance nodig hebben.

Sample request

POST /api/v1/pdf/render: een minimale dynamische PDF gegenereerd uit JSON.

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

Compliance and conformance

  • PDF/A-profielen zijn beschikbaar wanneer gegenereerde PDFs moeten worden gearchiveerd of als auditbewijs worden bewaard.
  • Documentmetadata kan in dezelfde request worden gezet, zodat titel, auteur, onderwerp en taal consistent blijven.
  • Hetzelfde gestructureerde model werkt in de API en in de visuele editor op https://studio.gpdf.com.

Als je alleen een eenmalige PDF-generator nodig hebt

Voor een Word-document converteren, bestanden samenvoegen of één pagina exporteren is een gewone online tool genoeg. Die flow is handmatig: uploaden, klikken, downloaden.

gPdf is bedoeld voor het moment waarop je applicatie zelf PDFs moet maken, automatisch en betrouwbaar.

Wanneer “PDF-generator” eigenlijk PDF-generatie-API betekent

De zoekterm is breed, maar in een product- of operations-team wordt de vraag snel concreet:

  1. Een bestelling komt binnen en de backend moet een verzendlabel maken.
  2. Een SaaS-product genereert periodieke rapporten per klant.
  3. Finance heeft facturen nodig met stabiele metadata en archiefinstellingen.
  4. Een magazijn moet tienduizenden labels klaarzetten voor carrier pickup.
  5. Support of operations exporteert bonnen, certificaten of klantdossiers in huisstijl.

Dan gaat het niet meer om de knop die een PDF maakt. Het gaat erom of je backend uit data steeds opnieuw het juiste document kan genereren, met voorspelbare latency en kosten.

Het gPdf-model: JSON erin, PDF eruit

gPdf gebruikt een gestructureerd JSON-documentmodel. Je applicatie stuurt:

  • paginaformaat en layoutcoördinaten,
  • tekstblokken en fontkeuzes,
  • afbeeldingen, tabellen en vectorbarcodes,
  • metadata en documentinstellingen,
  • optionele PDF/A- of e-invoice-configuratie.

De API geeft de PDF terug. Er is geen Chromium-server om warm te houden, geen browserversie om vast te pinnen en geen HTML/CSS-engine in het hete pad.

Waarom dit telt bij batchgeneratie

Een generieke PDF-generator is handig voor één gebruiker. Hij is niet gebouwd voor een systeem dat de hele dag documenten produceert.

Bij batchgewijze PDF-generatie tellen vooral:

  • deterministische output voor herdruk en audit,
  • stabiele p99-latency wanneer de queue piekt,
  • voorspelbare kosten per pagina,
  • fonts en barcodes die niet verschuiven tussen containerimages,
  • JSON-requests die je kunt versionen, testen en terugrollen.

Dat is precies de workload waarvoor gPdf is ontworpen.

Begin met een eenvoudige API-call

Open de Playground om het JSON-model te proberen voordat je integreert. Voor de backendkoppeling gebruik je de JSON Render API referentie.

Als je eerste use case logistiek of ecommerce is, lees dan ook wanneer gPdf past bij PDF-generatie voor logistiek en ecommerce.

FAQ

Is gPdf een gewone online PDF-generator?
Niet in de zin van uploaden, converteren en downloaden. gPdf is een API voor producten, backends en operationele systemen die automatisch PDFs genereren.
Kan ik dynamische PDFs uit JSON genereren?
Ja. Een DocumentRequest beschrijft pagina's, tekst, afbeeldingen, barcodes, tabellen, metadata en instellingen. Je applicatie stuurt JSON en ontvangt een PDF.
Wanneer gebruik ik gPdf in plaats van een headless browser?
Gebruik gPdf voor gestructureerde, herhaalbare documenten met hoog volume: labels, facturen, rapporten, certificaten en bedrijfsdocumenten. Voor willekeurige HTML-screenshots blijft een browser nuttig.
Kunnen niet-technische teams het ontwerp aanpassen?
Ja. De visuele editor op https://studio.gpdf.com gebruikt hetzelfde JSON-model, zodat operations of design het layoutwerk kunnen doen terwijl developers de API-flow behouden.

Keep reading