gPdf
Gebruiksscenario's · PDF-generatie-API

PDF-generatie-API voor dynamische bedrijfsdocumenten

Zoekt u een PDF-generator? gPdf is een JSON-naar-PDF-API voor developers die geautomatiseerde batchgewijze PDF-generatie nodig hebben voor verzendlabels, facturen, rapporten en archiefdocumenten.

Uit te voeren taak

Zet bedrijfsdata automatisch om naar productie-PDF's: verzendlabels, facturen, rapporten, certificaten en klantgerichte documenten die vanuit JSON binnen uw applicatie worden gegenereerd, zonder gebruikers handmatig bestanden te laten uploaden naar een online PDF-generator.

Waarom gPdf hiervoor past

  • JSON-naar-PDF-generatie: definieer pagina's, tekst, afbeeldingen, tabellen, barcodes en metadata in één gestructureerde DocumentRequest.
  • API-first proces: roep POST /api/v1/pdf/render aan vanuit uw backend, jobrunner, magazijnsysteem of SaaS-product.
  • Batchklare rendering: genereer duizenden of miljoenen PDF's zonder een browserpark te beheren.
  • Ingebouwde fonts voor Latin, CJK, Arabisch, Devanagari, Bengaals, Thai en Cyrillisch.
  • Vectorbarcodes en etiketten met vaste afmetingen voor logistiek, e-commerce en voorraaddocumenten.
  • PDF/A, metadata en e-factuuropties wanneer het gegenereerde document bewaring of nalevingsafhandeling nodig heeft.

Voorbeeldrequest

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 en conformiteit

  • PDF/A-profielen zijn beschikbaar wanneer gegenereerde PDF's langdurig moeten worden bewaard of aan auditbewijs moeten worden gekoppeld.
  • Documentmetadata kan direct in dezelfde request worden gezet, zodat gegenereerde PDF's een stabiele titel, auteur, onderwerp en taal behouden.
  • Hetzelfde gestructureerde model kan worden gebruikt vanuit de API of de visuele editor op https://studio.gpdf.com.

Als u alleen een eenmalige PDF-generator nodig hebt

Als u een Word-document wilt converteren, twee bestanden wilt samenvoegen of één pagina als PDF wilt exporteren, is een gewone online PDF-generator voldoende. Die tools zijn gebouwd voor handmatig werk: bestand uploaden, op een knop klikken, resultaat downloaden.

gPdf is bedoeld voor een andere taak. Het is voor teams die hun eigen software automatisch PDF’s laten genereren.

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

De zoekterm is breed, maar de productie-eis is meestal specifiek:

  1. Een klant plaatst een order en uw systeem moet een verzendlabel genereren.
  2. Een SaaS-product moet maandelijkse overzichten of rapporten maken.
  3. Een financieel proces heeft facturen nodig met voorspelbare metadata en archiefinstellingen.
  4. Een magazijnsysteem heeft 50.000 etiketten nodig voordat de vervoerder ophaalt.
  5. Een supporttool heeft een PDF-bon, certificaat of export in huisstijl nodig.

In al deze gevallen is de kernvraag niet: “welke knop genereert een PDF?” De vraag is: kan uw backend vanuit data herhaaldelijk, snel en goedkoop de juiste PDF genereren?

Het gPdf-model: JSON erin, PDF eruit

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

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

De API retourneert een PDF. Er is geen browserserver om warm te houden, geen Chromium-versie om vast te pinnen en geen HTML/CSS-layoutengine in het hete pad.

Waarom dit telt bij batchgeneratie

Generieke PDF-generatortools zijn handig voor een persoon. Ze zijn niet gebouwd voor een systeem dat de hele dag documenten maakt.

Voor batchgeneratie zijn vooral deze eigenschappen belangrijk:

  • deterministische output voor herdrukken en audittrails,
  • lage p99-latency wanneer een wachtrij piekt,
  • voorspelbare kosten per gegenereerde pagina,
  • fonts en barcodegeometrie die niet veranderen met containerimages,
  • een requestvorm die developers kunnen versioneren en testen.

Dat is de werklast waarop gPdf is gericht.

Begin met een eenvoudige API-call

Open de Playground als u het JSON-model wilt proberen voordat u code aansluit. Zodra u klaar bent om te integreren, gebruikt u de JSON Render API-referentie en verstuurt u dezelfde request vanuit uw backend.

Als uw eerste werklast logistiek is, lees dan ook de use case voor verzendlabels. Die laat hetzelfde patroon zien toegepast op 4×6 thermische etiketten, barcodes van vervoerders en generatie bij piekvolume.

FAQ

Is gPdf een online PDF-generator?
Niet in de consumentenbetekenis van uploaden en converteren. gPdf is een developer-API voor geautomatiseerde PDF-generatie binnen producten, backends en operationele systemen.
Kan ik dynamisch PDF's genereren vanuit JSON?
Ja. Een DocumentRequest beschrijft pagina's, tekst, afbeeldingen, barcodes, tabellen, metadata en instellingen. Uw applicatie stuurt JSON en ontvangt een PDF.
Wanneer gebruik ik gPdf in plaats van een headless browser?
Gebruik gPdf wanneer het document gestructureerd, herhaalbaar en hoogvolume is: etiketten, facturen, rapporten, certificaten en gegenereerde bedrijfsdocumenten. Browserrendering blijft nuttig voor willekeurige HTML-screenshots.
Kunnen niet-developers de PDF ontwerpen?
Ja. De visuele editor op https://studio.gpdf.com werkt met hetzelfde JSON-model, zodat een operations- of designteamgenoot de layout kan aanpassen terwijl developers het API-proces behouden.

Verder lezen