FAQ

Pertanyaan yang sebenarnya ditanyakan developer.

Dua belas jawaban — dikutip secara harfiah oleh JSON-LD FAQPage yang dikonsumsi Google rich results.

/01

Seberapa cepat gPdf merender PDF?

p50 adalah 3 ms dan p99 adalah 8 ms pada satu halaman A4 yang diukur dari 1000 invocation. Total wall time edge termasuk jaringan biasanya 8-15 ms.

/02

Format input apa yang diterima API?

Body DocumentRequest dalam JSON. Halaman, elemen, layer, watermark, header, footer, dan tabel semua diekspresikan secara struktural — tanpa HTML, tanpa Markdown, tanpa pass layout browser.

/03

Bagaimana gPdf dibandingkan dengan Puppeteer atau headless Chrome?

Headless Chromium berjalan di 200-800 ms per render dan butuh container 800 MB. gPdf merender halaman A4 yang sama dalam 3 ms di V8-isolate 1 MB, tanpa cold start. Trade-off-nya adalah format input: gPdf menerima JSON DocumentRequest, bukan HTML mentah.

/04

Apa endpoint API gPdf?

Tiga: /api/v1/pdf/render menerima DocumentRequest lengkap untuk kontrol level pixel. /api/v1/template-render menerima template_id plus array data. /api/v1/e-invoice/render menghasilkan faktur hybrid Factur-X / ZUGFeRD (PDF/A-3 + XML tertanam). Ketiganya berbagi engine yang sama, rate limit yang sama, dan permukaan kode error yang sama.

/05

Apakah saya perlu menginstal font di server untuk China, Jepang, atau Korea?

Tidak. NotoSans CJK tertanam dan rantai fallback otomatis menangani glyph yang hilang. Anda tidak akan pernah melihat kotak tofu dan tidak perlu apt install fonts-noto-cjk di runtime.

/06

Barcode apa yang bisa saya render?

Lebih dari 30 simbologi termasuk QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode, dan Code 128. Semua vektor. Total panjang barcode dalam 0,1 mm dari ukuran yang diminta — cukup presisi untuk lebar label yang ditentukan GS1 dan ITF-14.

/07

Apakah gPdf menghasilkan output PDF/A atau faktur elektronik yang sesuai?

Ya. PDF/A-1b, 2b, 3b, dan 4 dapat dipilih per request. Stream lampiran Factur-X dan ZUGFeRD didukung untuk skenario faktur elektronik.

/08

Bisakah gPdf memproduksi faktur elektronik Factur-X, ZUGFeRD, atau EN 16931?

Ya. Atur settings.profile ke pdfa-3b dan lampirkan payload XML terstruktur sebagai stream file. Factur-X dan ZUGFeRD berjalan di atas PDF/A-3 — diperlukan untuk mandat faktur elektronik Jerman yang sudah berlaku dan mandat B2B Prancis dari September 2026.

/09

Di mana sebenarnya gPdf berjalan?

Di dalam V8-isolate Cloudflare Workers. Tidak ada container Chromium, tidak ada Lambda warming, dan tidak ada persistensi dokumen setelah request.

/10

Apakah gPdf menyimpan PDF atau data input saya?

Tidak. Renderer-nya stateless. DocumentRequest Anda hidup di V8-isolate selama beberapa milidetik render, lalu hilang. gPdf tidak punya layer caching atau penyimpanan dokumen — statelessness adalah kontrak, bukan opt-in.

/11

Apakah ada tier gratis?

Ya. Free Trial memberikan 100 halaman per hari, tanpa kartu kredit. Reset harian dan berhenti di kuota — tanpa tagihan kejutan. Tier berbayar mulai dari $5 per bulan untuk 100.000 halaman.

/12

Bagaimana cara mulai menggunakan gPdf?

Buka playground di atas, edit DocumentRequest, lalu tekan Buat PDF — edge worker live mengembalikan PDF nyata. Salin snippet curl ke terminal Anda untuk memanggilnya dari mana saja. Playground tidak memerlukan instalasi atau kartu kredit; akun hanya dibutuhkan untuk menerbitkan API key Anda sendiri.