/01
gPdf bir PDF'i ne kadar hızlı render eder?
1000 çağrı üzerinde tek bir A4 sayfada p50 3 ms ve p99 8 ms'dir. Ağ dahil toplam edge wall time tipik olarak 8-15 ms'dir.
FAQ
Geliştiricilerin gerçekten sorduğu sorular.
On iki yanıt — Google rich results'ın tükettiği JSON-LD FAQPage tarafından kelimesi kelimesine alıntılanır.
/02
API hangi giriş formatını kabul eder?
JSON DocumentRequest gövdesi. Sayfalar, elemanlar, katmanlar, filigranlar, başlıklar, altbilgiler ve tablolar yapısal olarak ifade edilir — HTML yok, Markdown yok, tarayıcı layout pass'i yok.
/03
gPdf, Puppeteer veya headless Chrome ile nasıl karşılaştırılır?
Headless Chromium render başına 200-800 ms çalışır ve 800 MB konteyner gerektirir. gPdf aynı A4 sayfayı 1 MB V8 isolate içinde 3 ms'de render eder, cold start yok. Trade-off giriş formatıdır: gPdf JSON DocumentRequest alır, ham HTML almaz.
/04
gPdf API endpoint'leri nelerdir?
Üç: /api/v1/pdf/render piksel düzeyinde kontrol için tam DocumentRequest alır. /api/v1/template-render template_id artı veri dizisi alır. /api/v1/e-invoice/render Factur-X / ZUGFeRD hibrit faturalar (PDF/A-3 + gömülü XML) üretir. Üçü de aynı engine, aynı rate limit ve aynı hata kodu yüzeyini paylaşır.
/05
Çince, Japonca veya Korece için sunucuma font yüklemem gerekiyor mu?
Hayır. NotoSans CJK gömülüdür ve otomatik font fallback zinciri eksik glifleri ele alır. Asla tofu kutusu görmeyecek ve runtime'ınızda apt install fonts-noto-cjk'ye ihtiyaç duymayacaksınız.
/06
Hangi barkodları render edebilirim?
QR, GS1-128, PDF417, DataMatrix, Aztec, MaxiCode ve Code 128 dahil 30'dan fazla semboloji. Hepsi vektör. Toplam barkod uzunluğu istenen boyutun 0,1 mm'si içinde — GS1 ve ITF-14 tarafından belirtilen etiket genişlikleri için yeterince hassas.
/07
gPdf, PDF/A veya e-fatura uyumlu çıktı üretir mi?
Evet. PDF/A-1b, 2b, 3b ve 4 istek başına seçilebilir. Factur-X ve ZUGFeRD ek akışları e-fatura senaryoları için desteklenir.
/08
gPdf, Factur-X, ZUGFeRD veya EN 16931 e-faturaları üretebilir mi?
Evet. settings.profile'ı pdfa-3b olarak ayarlayın ve yapılandırılmış XML payload'ı dosya akışı olarak ekleyin. Factur-X ve ZUGFeRD PDF/A-3 üzerinde çalışır — yürürlükteki Alman e-fatura mandatı ve Eylül 2026'dan itibaren Fransız B2B mandatı için gerekli.
/09
gPdf gerçekten nerede çalışıyor?
Cloudflare Workers V8 isolate'leri içinde. Chromium konteyneri yok, Lambda warming yok, istek sonrası belge persistance'ı yok.
/10
gPdf, PDF'lerimi veya giriş verilerimi saklar mı?
Hayır. Renderer stateless'tır. DocumentRequest'iniz V8 isolate'te render'ın birkaç milisaniyesi boyunca yaşar, sonra kaybolur. gPdf'in caching katmanı veya belge deposu yok — statelessness sözleşmedir, opt-in toggle değil.
/11
Ücretsiz katman var mı?
Evet. Free Trial günde 100 sayfa verir, kredi kartı gerekmez. Günlük otomatik resetlenir ve kotada durur — sürpriz fatura yok. Ücretli katmanlar 100.000 sayfa için aylık $5'dan başlar.
/12
gPdf'i kullanmaya nasıl başlarım?
Yukarıdaki playground'u açın, DocumentRequest’i düzenleyin ve PDF oluştur’a basın — canlı edge worker gerçek bir PDF döndürür. Curl snippet'ini terminalinize kopyalayın, her yerden çağırın. Playground kurulum veya kredi kartı gerektirmez; sadece kendi API key'inizi vermek için bir hesap gereklidir.