/01
Quanto velocemente gPdf renderizza un PDF?
Il p50 è 3 ms e il p99 è 8 ms su una singola pagina A4 misurato su 1000 invocazioni. Il tempo totale al edge, inclusa la rete, è tipicamente 8-15 ms.
FAQ
Domande che gli sviluppatori fanno davvero.
Dodici risposte — citate testualmente dal JSON-LD FAQPage che i Google rich results consumano.
/02
Quale formato di input accetta l'API?
Un body DocumentRequest in JSON. Pagine, elementi, livelli, filigrane, intestazioni, piè di pagina e tabelle sono tutti espressi strutturalmente — niente HTML, niente Markdown, niente passaggio di layout del browser.
/03
Come si confronta gPdf con Puppeteer o Chrome headless?
Chromium headless va a 200-800 ms per render e necessita di un container da 800 MB. gPdf renderizza la stessa pagina A4 in 3 ms dentro un isolate V8 da 1 MB, senza cold start. Il trade-off è il formato di input: gPdf accetta un DocumentRequest JSON, non HTML grezzo.
/04
Quali sono gli endpoint dell'API gPdf?
Tre: /api/v1/pdf/render accetta un DocumentRequest completo per controllo a livello di pixel. /api/v1/template-render accetta template_id più un array di dati per sistemi con template pubblicato. /api/v1/e-invoice/render produce fatture ibride Factur-X / ZUGFeRD (PDF/A-3 + XML incorporato). Tutti e tre condividono lo stesso engine, gli stessi rate limit e la stessa superficie di codici di errore.
/05
Devo installare font sul mio server per cinese, giapponese o coreano?
No. NotoSans CJK è incorporato e una catena di fallback automatico gestisce i glifi mancanti. Non vedrai mai box tofu e non hai bisogno di apt install fonts-noto-cjk sul tuo runtime.
/06
Quali codici a barre posso renderizzare?
Oltre 30 simbologie tra cui QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode e Code 128. Tutti vettoriali. La lunghezza totale del codice a barre è entro 0,1 mm dalla dimensione richiesta — abbastanza precisa per le larghezze di etichetta specificate da GS1 e ITF-14.
/07
gPdf produce output conformi a PDF/A o fattura elettronica?
Sì. PDF/A-1b, 2b, 3b e 4 sono selezionabili per richiesta. I flussi di allegato Factur-X e ZUGFeRD sono supportati per scenari di fattura elettronica.
/08
gPdf può produrre fatture Factur-X, ZUGFeRD o EN 16931?
Sì. Imposta settings.profile su pdfa-3b e allega il payload XML strutturato come stream di file. Factur-X e ZUGFeRD si basano su PDF/A-3 — richiesto per il mandato tedesco di e-fattura già in vigore e per il mandato francese B2B da settembre 2026.
/09
Dove gira effettivamente gPdf?
Dentro isolates V8 di Cloudflare Workers. Niente container Chromium, niente warming Lambda, e niente persistenza di documento dopo la richiesta.
/10
gPdf memorizza i miei PDF o dati di input?
No. Il renderer è stateless. Il tuo DocumentRequest vive in un isolate V8 per i pochi millisecondi del rendering, poi scompare. gPdf non ha layer di cache né storage di documenti — l'assenza di stato è il contratto, non un opt-in.
/11
C'è un piano gratuito?
Sì. La Free Trial dà 100 pagine al giorno, senza carta di credito. Si resetta giornalmente e si ferma alla quota — niente fatture sorpresa. I piani a pagamento partono da $5 al mese per 100.000 pagine.
/12
Come inizio a usare gPdf?
Apri il playground sopra, modifica il DocumentRequest e premi Genera PDF — il worker live all’edge restituisce un PDF reale. Copia lo snippet curl nel tuo terminale per chiamarlo da qualsiasi posto. Il playground non richiede installazione né carta di credito; un account è necessario solo per emettere la tua API key.