gPdf render/edge
Use cases · PDF oluşturma API'si

Dinamik iş belgeleri için PDF oluşturma API'si

PDF oluşturucu mu arıyorsunuz? gPdf, geliştiricilerin etiket, fatura, rapor ve arşiv belgelerini JSON'dan otomatik ve toplu üretmesi için bir PDF Generation API'dir.

Job to be done

Sipariş, fatura, rapor, sertifika ve kargo etiketi gibi iş verilerini uygulama backend'inden otomatik olarak PDF'ye dönüştürün. Kullanıcıların dosya yüklemesine veya operasyon ekibinin belgeleri tek tek dışa aktarmasına gerek kalmadan, sistem JSON gönderir ve tutarlı PDF alır.

Why gPdf for this

  • JSON-to-PDF üretimi: sayfaları, metni, görselleri, tabloları, barkodları ve metadata alanlarını tek bir DocumentRequest içinde tanımlayın.
  • API-first workflow: POST /api/v1/pdf/render çağrısını backend, job queue, depo sistemi veya SaaS ürününden yapın.
  • Toplu üretime hazır: Puppeteer veya Playwright cluster işletmeden yüksek hacimli PDF oluşturun.
  • Latin, CJK, Arabic, Devanagari, Bengali, Thai ve Cyrillic içerik için yerleşik font desteği.
  • Operasyonel belgeler: fixed-size label, vector barcode, PDF metadata, PDF/A ve e-invoice seçenekleri.
  • Aynı JSON modeli API'de ve https://studio.gpdf.com Visual Editor içinde kullanılabilir.

Sample request

POST /api/v1/pdf/render: JSON'dan minimal bir dinamik PDF üretme örneği.

{
  "pages": [
    {
      "size": "a4",
      "elements": [
        {
          "type": "text",
          "x": 24,
          "y": 28,
          "content": "Order #A-10042",
          "style": {
            "font_size": 18,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "text",
          "x": 24,
          "y": 44,
          "content": "Generated automatically from application data.",
          "style": {
            "font_size": 10,
            "font_family": "NotoSans-Regular"
          }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "A-10042",
          "x": 24,
          "y": 70,
          "width": 80,
          "height": 18
        }
      ]
    }
  ]
}

Compliance and conformance

  • Arşivleme veya denetim kanıtı gereken PDF'lerde PDF/A profili aynı request içinde yapılandırılabilir.
  • Title, Author, Subject ve Language gibi PDF metadata alanları doğrudan ayarlanarak arama ve arşiv süreçleri daha tutarlı hale getirilebilir.
  • Operasyon veya tasarım ekipleri layout üzerinde çalışacaksa aynı JSON modeli https://studio.gpdf.com içinde düzenlenebilir.

Sadece tek seferlik bir PDF gerekiyorsa

Bir Word belgesini PDF’ye çevirmek, birkaç görseli birleştirmek veya tek bir sayfayı PDF olarak kaydetmek istiyorsanız sıradan online PDF oluşturucular yeterlidir. Bu araçlar manuel kullanım içindir: dosya yüklenir, butona basılır, sonuç indirilir.

gPdf başka bir işi hedefler: iş yazılımınızın PDF’leri kendi akışı içinde otomatik üretmesi.

“PDF oluşturucu” araması aslında API ihtiyacı olduğunda

“PDF generator”, “PDF generation API”, “dynamic PDF generation” ve “batch PDF generation” gibi aramalar geniş görünebilir. Ancak üretim aşamasında ihtiyaç genellikle nettir.

  1. Sipariş oluşur ve sistem kargo etiketi üretmelidir.
  2. Bir SaaS ürünü her müşteri için aylık rapor hazırlamalıdır.
  3. Finans akışı metadata ve arşiv ayarları tutarlı faturalar üretmelidir.
  4. Depo, kargo alımı öncesinde on binlerce etiketi hazır etmelidir.
  5. Destek veya admin aracı markalı makbuz, sertifika ya da dışa aktarım belgesi sunmalıdır.

Bu noktada soru “hangi buton PDF üretir?” değildir. Asıl soru backend’inizin veriden doğru PDF’yi tekrar tekrar, hızlı ve öngörülebilir maliyetle üretip üretemeyeceğidir.

gPdf modeli: JSON girer, PDF çıkar

gPdf yapılandırılmış bir JSON belge modeli kullanır. Uygulamanız şunları gönderir:

  • sayfa boyutu ve koordinatlı layout,
  • metin, font seçimi, görsel ve tablo,
  • vector barcode ve fixed-size label,
  • PDF metadata,
  • gerektiğinde PDF/A, e-invoice veya arşiv ayarları.

API PDF döndürür. Browser server ısıtmanız, Chromium sürümü sabitlemeniz veya HTML/CSS rendering engine’i belge üretiminin hot path’ine koymanız gerekmez.

Toplu PDF üretiminde neden önemlidir

Genel PDF oluşturucular bireysel işler için kullanışlıdır. Gün boyu belge üreten sistemler ise farklı özelliklere ihtiyaç duyar.

Batch generation için önemli olanlar:

  • reprint ve audit trail için deterministik çıktı,
  • queue yükseldiğinde kontrol edilebilir p99 latency,
  • sayfa başına öngörülebilir maliyet,
  • container image değiştikçe bozulmayan font ve barkod geometrisi,
  • version, test ve rollback yapılabilen JSON request yapısı.

gPdf’in hedeflediği iş yükü budur.

Basit bir API çağrısıyla başlayın

Entegrasyondan önce JSON modelini denemek için Playground sayfasını açın. Backend’e bağlamaya hazır olduğunuzda JSON Render API referansını kullanarak aynı request’i sisteminizden gönderin.

İlk iş yükünüz lojistik veya ecommerce ise gPdf’in lojistik ve ecommerce PDF üretimine uygun olduğu durumlar yazısını da okuyun.

FAQ

gPdf sıradan bir online PDF oluşturucu mu?
Hayır. gPdf, dosya yükleyip dönüştürmeye yönelik tüketici aracı değil; ürünler, backend'ler ve operasyon sistemleri içinde otomatik PDF üretimi için geliştirici API'sidir.
JSON'dan dinamik PDF oluşturabilir miyim?
Evet. DocumentRequest sayfaları, metni, görselleri, tabloları, barkodları, metadata ve belge ayarlarını tarif eder. Uygulamanız JSON gönderir ve PDF alır.
Headless browser yerine ne zaman gPdf kullanmalıyım?
Belge yapısı belirli, tekrar eden ve yüksek hacimli ise gPdf uygundur: shipping label, invoice, report, certificate ve otomatik iş belgeleri gibi.
Geliştirici olmayan ekipler layout üzerinde çalışabilir mi?
Evet. https://studio.gpdf.com aynı JSON modelini kullanır; operasyon veya tasarım ekibi layout'u düzenlerken geliştiriciler API workflow'unu koruyabilir.

Keep reading