Production sistemleri için template tabanlı PDF API
template tabanlı PDF çıktısını yapılandırılmış backend verilerinden tarayıcı olmadan üretin; gPdf PDF rendering’i üstlenir, iş kuralları sisteminizde kalır.
/api/v1/template-render template tabanlı PDF çıktısını yapılandırılmış veriden tekrarlanabilir PDF olarak üretmek. gPdf PDF’i render eder; veri anlamı ve süreç durumu sisteminizde kalır.
Bu API ne zaman kullanılır
- Backend’inizde template tabanlı PDF verisi zaten var ve kararlı bir PDF yanıtı gerekiyor.
- Operasyon belgesi için Chromium veya HTML-to-PDF kullanmak istemiyorsunuz.
- Reprint, audit veya batch için tekrarlanabilir çıktı gerekiyor.
Neyin yerine geçmez
- gPdf kargo satın almaz, vergi beyan etmez, dış sipariş oluşturmaz ve mali sistem değildir.
- Veri doğrulama, iş kuralları veya marketplace entegrasyonlarının yerine geçmez.
Hangi endpoint çağrılır
/api/v1/template-render
Template Render bu iş akışı için varsayılan yoldur.
/api/v1/pdf/render
İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.
Minimum request
/api/v1/template-render - template tabanlı PDF
{
"template_id": "invoice",
"data": [
{
"invoice_number": "INV-2026-001",
"date_of_issue": "2026-05-29",
"date_due": "2026-06-28",
"issuer_name": "Acme Cloud Inc.",
"issuer_address": "88 Harbor Rd, Long Beach, CA",
"bill_to_name": "Receiver Inc.",
"bill_to_address": "123 Main St, Los Angeles, CA",
"subtotal": "$100.00",
"total": "$100.00",
"amount_due": "$100.00",
"items": [
{
"description": "Service A",
"qty": 1,
"unit_price": "$100.00",
"amount": "$100.00"
}
]
}
]
}
gPdf neyi üstlenir
- Yapılandırılmış request üzerinden template tabanlı PDF için PDF rendering.
- Request’e göre metin, tablo, çizgi, barkod, sayfa, metadata ve çıktı ayarları.
- Retry, reprint ve audit için deterministik çıktı.
Sisteminiz neyi yönetir
- template tabanlı PDF için doğru veri, iş kuralları ve operasyon durumu.
- Kimlik doğrulama, kalıcı kayıt, dış workflow ve alıcı sistem doğrulamaları.
Production checklist
- Gerçek veri ve PDF’i tüketecek sistemlerle test edin.
- Support, audit ve reprint için request ID ve doğrulama kanıtlarını saklayın.
- Onaylı layout birden fazla sistemde kullanılacaksa template’e taşıyın.
İddia sınırları
- gPdf request’ten PDF render eder; ürün workflow’u, database veya business validation yerine geçmez.
- Data semantics, retries, storage ve final acceptance sisteminizdedir.
API şekli
template tabanlı PDF API, gPdf public API’leri üzerinde çalışan bir production workflow’dur. Request veriyi, layout’u, settings’i ve render edilecek PDF parçalarını açıkça tarif eder. gPdf PDF’i üretir; iş olayının semantiği sisteminizde kalır.
Endpoint seçimi
Bu workflow için varsayılan endpoint /api/v1/template-render. Layout onaylandıktan sonra Template Render kullanın. E-Invoice Render yalnızca EN 16931 CII XML gömülü Factur-X / ZUGFeRD PDF/A-3b paketleme gerektiğinde kullanılır.
Production öncesi doğrulama
template tabanlı PDF çıktısını gerçek veriyle ve downstream sistemlerle doğrulayın. Support, audit ve reprint için request ID, render edilen çıktı ve doğrulama kanıtlarını saklayın.
FAQ
- Bu ayrı bir endpoint mi?
- template tabanlı PDF API, workflow’u gPdf’in public API’lerinden birine bağlar. Sayfa hangi path’in çağrılacağını ve request’in neyi taşıyacağını açıklar.
- Templates kullanabilir miyim?
- Evet. Layout değişirken JSON Render, layout onaylandıktan ve callers yalnızca iş verisi gönderdikten sonra Template Render kullanın.
- Production öncesi neyi doğrulamalıyım?
- Gerçek veriyle ve workflow’daki yazıcı, scanner, validator, muhasebe sistemi veya marketplace ile doğrulayın.