gPdf
Use cases · PDF oluşturma API'si

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

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

Job to be done

İş verilerini otomatik olarak üretim PDF'lerine dönüştürün: gönderi etiketleri, faturalar, raporlar, sertifikalar ve müşteriye dönük belgeler uygulamanızın içindeki JSON'dan oluşturulur; kullanıcıların dosyaları elle bir çevrim içi PDF oluşturucuya yüklemesi gerekmez.

Why gPdf for this

  • JSON'dan PDF'ye üretim: sayfaları, metni, görselleri, tabloları, barkodları ve metadata alanlarını tek bir yapılandırılmış DocumentRequest içinde tanımlayın.
  • API öncelikli iş akışı: POST /api/v1/pdf/render çağrısını backend'inizden, job runner'ınızdan, depo sisteminizden veya SaaS ürününüzden yapın.
  • Toplu render için hazır: tarayıcı filosu yönetmeden binlerce veya milyonlarca PDF üretin.
  • Latin, CJK, Arapça, Devanagari, Bengalce, Tayca ve Kiril içerikleri için yerleşik fontlar.
  • Lojistik, e-ticaret ve envanter belgeleri için vektör barkod ve sabit boyutlu etiket desteği.
  • Oluşturulan belgenin arşiv veya uyumluluk akışına girmesi gerektiğinde PDF/A, metadata ve e-invoice seçenekleri.

Sample request

POST /api/v1/pdf/render: JSON'dan üretilen minimal bir dinamik PDF.

{
  "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

  • Oluşturulan PDF'lerin arşivlenmesi veya denetim kanıtına eklenmesi gerektiğinde PDF/A profilleri kullanılabilir.
  • Belge metadata alanları aynı request içinde doğrudan ayarlanabilir; böylece oluşturulan PDF'ler sabit title, author, subject ve language değerlerini korur.
  • Aynı yapılandırılmış model API'den veya https://studio.gpdf.com üzerindeki görsel editörden kullanılabilir.

Yalnızca tek seferlik bir PDF oluşturucuya ihtiyacınız varsa

Bir Word belgesini dönüştürmek, iki dosyayı birleştirmek veya tek bir sayfayı PDF olarak dışa aktarmak istiyorsanız, sıradan bir çevrim içi PDF oluşturucu yeterlidir. Bu araçlar manuel iş için tasarlanmıştır: dosya yüklenir, bir düğmeye tıklanır, sonuç indirilir.

gPdf farklı bir iş içindir. Kendi yazılımlarının PDF’leri otomatik üretmesini isteyen ekipler içindir.

“PDF oluşturucu” aslında “PDF oluşturma API’si” anlamına geldiğinde

Arama terimi geniştir, ancak üretim ihtiyacı genellikle nettir:

  1. Müşteri sipariş verir ve sisteminizin bir gönderi etiketi üretmesi gerekir.
  2. Bir SaaS ürünü aylık ekstreler veya raporlar oluşturmak zorundadır.
  3. Finans iş akışı öngörülebilir metadata ve arşiv ayarlarına sahip faturalar ister.
  4. Depo sistemi, kargo firması teslim almadan önce 50.000 etikete ihtiyaç duyar.
  5. Destek aracı markalı bir PDF makbuz, sertifika veya dışa aktarım belgesi üretmek zorundadır.

Bu durumların hiçbirinde temel soru “hangi düğme PDF üretir?” değildir. Asıl soru şudur: backend’iniz veriden doğru PDF’yi tekrar tekrar, hızlı ve düşük maliyetle üretebilir mi?

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 yerleşim koordinatları,
  • metin blokları ve font seçimleri,
  • görseller ve vektör barkodlar,
  • tablolar, metadata ve belge ayarları,
  • isteğe bağlı PDF/A veya e-invoice yapılandırması.

API PDF döndürür. Isıtılacak tarayıcı sunucusu yoktur, sabitlenecek Chromium sürümü yoktur ve PDF üretiminin kritik yoluna yerleşen HTML/CSS yerleşim motoru yoktur.

Bu neden toplu üretim için önemlidir

Genel PDF oluşturucu araçlar bir kişi için kullanışlıdır. Gün boyu belge oluşturan bir sistem için tasarlanmamışlardır.

Toplu üretimde önemli olan özellikler şunlardır:

  • yeniden baskı ve denetim izi için deterministik çıktı,
  • kuyruk yükseldiğinde düşük p99 latency,
  • oluşturulan sayfa başına öngörülebilir maliyet,
  • container image değiştiğinde değişmeyen font ve barkod geometrisi,
  • geliştiricilerin sürümlendirebileceği ve test edebileceği bir request şekli.

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

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

Kod bağlamadan önce JSON modelini denemek istiyorsanız Playground sayfasını açın. Entegrasyona hazır olduğunuzda JSON Render API referansını kullanın ve aynı isteği backend’inizden gönderin.

İlk iş yükünüz lojistik ise gönderi etiketi kullanım senaryosu sayfasını da okuyun. Aynı kalıbı 4×6 termal etiketlere, kargo firması barkodlarına ve tepe hacimde üretime uygular.

FAQ

gPdf bir çevrim içi PDF oluşturucu mu?
Tüketici tipi dosya yükle-dönüştür anlamında değil. gPdf; ürünlerin, backend'lerin ve operasyon sistemlerinin içinde otomatik PDF oluşturmak için kullanılan bir geliştirici API'sidir.
JSON'dan dinamik PDF oluşturabilir miyim?
Evet. DocumentRequest sayfaları, metni, görselleri, barkodları, tabloları, metadata alanlarını ve ayarları tarif eder. Uygulamanız JSON gönderir ve PDF alır.
Headless browser yerine ne zaman gPdf kullanmalıyım?
Belge yapılandırılmış, tekrar eden ve yüksek hacimli olduğunda gPdf kullanın: etiketler, faturalar, raporlar, sertifikalar ve oluşturulan iş belgeleri. Rastgele HTML ekran görüntüleri için tarayıcıyla render hâlâ yararlıdır.
Geliştirici olmayan ekipler PDF tasarlayabilir mi?
Evet. https://studio.gpdf.com üzerindeki görsel editör aynı JSON modeliyle çalışır; operasyon veya tasarım ekibinden biri yerleşimi ayarlarken geliştiriciler API iş akışını koruyabilir.

Keep reading