API per JSON in PDF nei sistemi di produzione
Genera JSON in PDF da dati backend strutturati, senza browser, con confini chiari tra il PDF renderizzato da gPdf e le regole del tuo sistema.
/api/v1/pdf/render Generare JSON in PDF come PDF riproducibile da dati strutturati. Il tuo sistema mantiene la logica di business; gPdf gestisce il rendering PDF.
Quando usare questa API
- Il tuo backend possiede già i dati per JSON in PDF e deve ottenere una risposta PDF stabile.
- Vuoi evitare Chromium o HTML-to-PDF per documenti operativi.
- Ti serve output ripetibile per ristampe, audit o batch.
Cosa non sostituisce
- Hai bisogno che gPdf acquisti spedizioni, liquidi imposte, crei ordini esterni o agisca da sistema fiscale.
- Vuoi sostituire validazione dati, logica di business o integrazioni marketplace.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo workflow.
/api/v1/template-render
Usalo quando il workflow richiede l’API collegata, un contratto di template o una verifica delle capacità.
Request minimo
/api/v1/pdf/render - JSON in PDF
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Hello from gPdf",
"style": {
"font_size": 18,
"font_family": "NotoSans-Regular"
}
}
]
}
]
}
Cosa gestisce gPdf
- Rendering PDF di JSON in PDF da request strutturate.
- Testi, tabelle, linee, codici a barre, pagine, metadati e opzioni di output secondo il request.
- Output deterministico per retry, ristampe e audit.
Cosa controlla il tuo sistema
- Dati corretti per JSON in PDF, regole di business e stato operativo.
- Autenticazione, persistenza, integrazioni esterne e validazione con i destinatari.
Checklist di produzione
- Testa con dati reali e con i sistemi che riceveranno il PDF.
- Salva request ID ed evidenze per supporto, audit e ristampa.
- Trasforma il layout approvato in template quando più sistemi devono riusarlo.
Limiti della promessa
- gPdf renderizza PDF dal request; non sostituisce workflow, database o validazione prodotto.
- Il tuo sistema mantiene semantica dati, retry, persistenza e accettazione finale.
Forma dell’API
API per JSON in PDF è un workflow di produzione basato sulle API pubbliche di gPdf. Il request descrive dati, layout, settings e parti PDF da renderizzare. gPdf renderizza il PDF; il tuo sistema mantiene la semantica dell’evento di business.
Scelta dell’endpoint
Per questo workflow, l’endpoint predefinito è /api/v1/pdf/render. Usa Template Render quando il layout è approvato e riutilizzato tra sistemi. Usa E-Invoice Render solo quando serve packaging Factur-X / ZUGFeRD PDF/A-3b con EN 16931 CII XML incorporato.
Validazione prima della produzione
Valida JSON in PDF con dati reali e con i sistemi che lo consumeranno. Conserva request ID, output renderizzato ed evidenze di validazione per supporto, audit e ristampa.
FAQ
- È un endpoint separato?
- API per JSON in PDF collega il workflow a una API pubblica di gPdf. La pagina indica quale percorso chiamare e cosa deve contenere il request.
- Posso usare template?
- Sì. Usa JSON Render mentre il layout cambia; usa Template Render quando il layout è approvato e i caller inviano solo dati di business.
- Cosa validare prima della produzione?
- Valida con dati reali e con stampanti, scanner, validatori, contabilità o marketplace del workflow.