gPdf render/edge
Use cases · API di generazione PDF

API per generare PDF dinamici nei sistemi aziendali

Cerchi un generatore PDF? gPdf è una API JSON-to-PDF per team che devono generare PDF dinamici e in batch direttamente dai sistemi aziendali.

Job to be done

Trasformare dati aziendali in PDF pronti per la consegna: etichette di spedizione, fatture, report, certificati e documenti cliente generati automaticamente da JSON dentro l'applicazione, senza upload manuali né esportazioni una per una.

Why gPdf for this

  • Generazione JSON-to-PDF: definisci pagine, testi, immagini, tabelle, codici a barre e metadati in un DocumentRequest strutturato.
  • Workflow API-first: chiama POST /api/v1/pdf/render da backend, job runner, sistema di magazzino o prodotto SaaS.
  • Pronto per il batch: genera migliaia o milioni di PDF senza gestire cluster di browser headless.
  • Font integrati per contenuti Latin, CJK, arabi, devanagari, bengalesi, thai e cirillici.
  • Codici a barre vettoriali e layout a dimensione fissa per logistica, ecommerce e inventario.
  • Opzioni PDF/A, metadati ed e-invoice quando il documento richiede archiviazione o compliance.

Sample request

POST /api/v1/pdf/render: un PDF dinamico minimo generato da 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

  • I profili PDF/A sono disponibili quando i PDF generati devono essere archiviati o allegati a evidenze di audit.
  • I metadati del documento possono essere impostati nella stessa richiesta per mantenere titolo, autore, oggetto e lingua coerenti.
  • Lo stesso modello strutturato funziona nell'API e nell'editor visuale su https://studio.gpdf.com.

Se ti serve solo un generatore PDF una tantum

Per convertire un documento Word, unire file o esportare una pagina una sola volta, un tool online tradizionale basta. È pensato per un flusso manuale: carica, clicca, scarica.

gPdf serve quando il PDF deve diventare parte del prodotto o dell’operazione, non un passaggio manuale a valle.

Quando “generatore PDF” significa API di generazione PDF

La ricerca può sembrare generica, ma in azienda il requisito diventa subito concreto:

  1. Arriva un ordine e il backend deve generare l’etichetta di spedizione.
  2. Un SaaS deve produrre report mensili per cliente.
  3. Finance deve emettere fatture con metadati stabili e impostazioni di archivio.
  4. Un magazzino deve stampare decine di migliaia di etichette prima del ritiro.
  5. Supporto o operations devono esportare ricevute, certificati o documenti brandizzati.

La domanda non è quale pulsante crea un PDF. La domanda è se il backend può generare il documento corretto dai dati, più volte, velocemente e con costi prevedibili.

Il modello gPdf: JSON in ingresso, PDF in uscita

gPdf usa un modello documento JSON strutturato. L’applicazione invia:

  • dimensione pagina e coordinate di layout,
  • blocchi di testo e scelte di font,
  • immagini, tabelle e codici a barre vettoriali,
  • metadati e impostazioni del documento,
  • eventuali opzioni PDF/A o e-invoice.

L’API restituisce il PDF. Non devi mantenere caldo un server Chromium, bloccare una versione del browser o mettere un motore HTML/CSS nel percorso critico.

Perché conta nella generazione in batch

Un generatore PDF generico è comodo per una persona. Non è progettato per un sistema che produce documenti tutto il giorno.

Nella generazione in batch contano:

  • output deterministico per ristampe e audit,
  • p99 stabile quando cresce la coda,
  • costo per pagina prevedibile,
  • font e codici a barre coerenti tra ambienti,
  • richieste JSON versionabili, testabili e ripristinabili.

Questo è il carico di lavoro per cui gPdf è pensato.

Inizia con una chiamata semplice

Apri il Playground per provare il modello JSON prima dell’integrazione. Quando vuoi collegarlo al backend, usa il riferimento JSON Render API.

Se il primo caso è logistica o ecommerce, leggi anche quando gPdf è adatto alla generazione di PDF per logistica ed ecommerce.

FAQ

gPdf è un normale generatore PDF online?
No, non nel senso consumer di caricare un file e scaricare una conversione. gPdf è una API per prodotti, backend e sistemi operativi che generano PDF automaticamente.
Posso generare PDF dinamici da JSON?
Sì. Un DocumentRequest descrive pagine, testo, immagini, codici a barre, tabelle, metadati e impostazioni. L'applicazione invia JSON e riceve un PDF.
Quando usare gPdf invece di un browser headless?
Quando il documento è strutturato, ripetuto e ad alto volume: etichette, fatture, report, certificati e documenti aziendali. Per HTML arbitrario, un browser può ancora essere utile.
Anche chi non sviluppa può lavorare sul layout?
Sì. L'editor visuale su https://studio.gpdf.com usa lo stesso modello JSON, quindi operations o design possono rifinire il layout mentre gli sviluppatori mantengono il workflow API.

Keep reading