Ürün ve API rehberi

Make ve Zapier entegrasyonları

Bağlantı kurmadan önce

Bir PDFgine müşteri hesabı, bu çalışma alanında bir şablon, kullanılabilir sayfa kotası ve Make veya Zapier hesabı gerekir. Önce şablonunuzu oluşturup Template Code değerini not edin.

Make uygulaması katalog incelemesinde. Zapier entegrasyonu özel erişime açık. Erişim için PDFgine ile iletişime geçin; iki entegrasyon da henüz genel katalogda listelenmiyor.

Entegrasyon erişimi isteyin

Çalışma alanınızı bağlayın

PDFgine hesabınızda usage:read ve documents:render izinleriyle ayrı bir API anahtarı oluşturun. Aşağıdaki barındırılan API adresini kullanın. Yalnız önizlemelerde isteğe bağlı Brand Kit seçicisini kullanıyorsanız templates:read ekleyin.

https://api.pdfgine.com · usage:read · documents:render

Bağlayıcının Locale seçicisi şu anda İngilizce ve Türkçe sunar. Site dili, belge verilerini veya bağlayıcının kullanılabilir alanlarını değiştirmez.

Make senaryosu kurun

  1. PDFgine tarafından sağlanan özel uygulama erişimini kabul edin. Senaryonuza bir PDFgine modülü ekleyip API adresiniz ve bu bağlantıya özel API anahtarınızla bağlantı oluşturun.
  2. Create a Document seçin, Template Code ve Format alanlarını ayarlayın, ardından önceki modülün değerlerini Template Data JSON nesnesine eşleyin. Asenkron işler için Queue a Document, alıcıya açılacak bağlantı için Create a Public Preview kullanın.
  3. Örnek verilerle Run once çalıştırıp modül sonucunu ve üretilen belgeyi inceleyin. Eşleme doğru olduktan sonra zamanlamayı açın. Make an API call, yetkili göreli API yollarını destekler; bağlantının izinleri geçerliliğini korur.

Zap kurun

  1. Zapier hesabınızda PDFgine özel entegrasyon davetini kabul edin. Tetikleyicinizi seçin, bir PDFgine aksiyonu ekleyin ve API adresiniz ile bağlantıya özel API anahtarınızla bağlanın.
  2. Create Document için Template Code ve Format alanlarını ayarlayıp tetikleyici verilerini geçerli JSON olarak Template Data alanına eşleyin. Queue Document ve Create Public Preview ayrı aksiyonlardır. Brand Kits isteğe bağlı bir açılır liste kaynağıdır; tetikleyici değildir.
  3. Aksiyonu test edin, Zap'i yayımlayın ve yeni bir tetikleyici olayı gönderin. Zap History içinde başarılı çalışmayı doğrulayıp o olayın belgesini inceleyin; yalnız editördeki Test Step, canlı akışın çalıştığını kanıtlamaz.

Gerçek değerleri eşleyin, JSON geçerli kalsın

Template Data, dosya yolu veya boş bir yer tutucu değil, şablonunuzun alanlarına uyan bir JSON nesnesi olmalıdır. Aşağıdaki örnek bir teklif şablonu içindir. Adları ve tutarları tetikleyicinizden eşleyin, sayısal değerleri sayı olarak tutun ve göndermeden önce hesaplanan toplamları doğrulayın.

JSON 
{
  "document": { "title": "DEMO ONLY" },
  "referenceNo": "DEMO-001",
  "issueDate": "2026-10-27",
  "currency": "USD",
  "customer": "Demo Customer",
  "quoteItems": [
    { "name": "Demo service", "quantity": 2, "unitPrice": 50, "total": 100 }
  ],
  "subtotal": 100,
  "vatAmount": 20,
  "grandTotal": 120
}

Doğru çıktıyı seçin

Create Document, API kimlik doğrulaması gerektiren korumalı bir downloadUrl döndürür. Müşterinin tarayıcıdan açacağı bağlantı için Create Public Preview kullanıp izin verilen bir erişim süresi seçin. Queue Document bir iş statusUrl değeri döndürür; kuyruğa alınmış yanıt tamamlanmış belge değildir.

Kuyruklu üretim · Önizleme bağlantısı

Açmadan önce test edin

Önce kurgusal müşteri verileri kullanın. Alıcıyı, referansı, kalemleri, toplamları ve çıktı biçimini kontrol edin. Akışı açtıktan sonra yeni bir olay gönderip platformun çalışma geçmişini doğrulayın. Tekrarlanan üretim çalıştırmalarından kaçının: üretilen sayfalar PDFgine kotanızı tüketir.

Limitler ve sorun giderme

401 veya 403 için bağlantıyı ve API izinlerini kontrol edin. 402 için kullanılabilir kotayı kontrol edin. 429 için Retry-After değerine uyup istek sıklığını azaltın. Tekrar denemeden önce geçersiz JSON veya şablon verisini düzeltin. Önizleme süresi ve üretim limitleri planınıza bağlıdır.

Hatalar · Kota sorgula

Bağlantı anahtarlarını gizli tutun

API anahtarınızı yalnız platformun bağlantı ayarlarına girin. Template Data, ekran görüntüleri veya paylaşılan çalışma kayıtlarına koymayın. Her bağlantı için ayrı anahtar kullanın; erişim gerekmiyorsa PDFgine üzerinden iptal edin.

Belge olaylarına mı ihtiyacınız var? API webhook rehberine bakın. Webhook'lar