Ürün ve API rehberi

Önizleme bağlantısı

Viewer ve gömme ayarları

Hesaptaki gömülü görüntüleyici ayarlarında görünümü, başlık ve sayfa gezinmesi seçeneklerini düzenleyebilirsiniz. PDFgine markasını kaldırma ve gömme erişimi plan yetkilerine bağlıdır; paneldeki kullanılabilirlik bilgisini kontrol edin.

İzin verilen siteler

Görüntüleyiciyi yerleştireceğiniz siteleri izin verilen sitelere ekleyin. Gömme izni ile paylaşım bağlantısının geçerliliği farklı kontrollerdir: siteye izin vermek süresi dolmuş veya iptal edilmiş bir paylaşımı yeniden açmaz. API anahtarını tarayıcıya veya iframe adresine koymayın.

Paylaşmadan önce kontrol edin

Bağlantıyı alıcının kullanacağı koşullarda deneyin. Sayfa sayısını, grafik ve tabloların yerleşimini, sunulan indirme biçimlerini ve geçerlilik süresini kontrol edin. İzin verilmeyen bir sitede gömme denemesi de yapın; hesap içindeki önizlemenin çalışması dışarıdan erişimin açık olduğunu tek başına kanıtlamaz.

Müşterinize üyelik gerektirmeyen, süreli bir görüntüleme bağlantısı üretir. Aynı çağrıda hem PDF hem DOCX indirme bağlantısı alabilirsiniz.

İstek 
curl -X POST https://api.pdfgine.com/api/v1/preview \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateCode": "invoice", "formats": ["pdf", "docx"], "data": { } }'
Cevap 
{
  "previewId": "prv_481fac83d9f14a4493021eb128d0876b",
  "previewUrl": "/p/prv_481fac83d9f14a4493021eb128d0876b",
  "expiresAt": "2026-08-29T13:23:43+00:00",
  "pageCount": 1,
  "downloads": [
    { "format": "pdf", "downloadUrl": "/api/v1/previews/prv_481f.../download/pdf?expires=...&token=..." },
    { "format": "docx", "downloadUrl": "/api/v1/previews/prv_481f.../download/docx?expires=...&token=..." }
  ]
}

Bağlantı tahmin edilemeyen bir imza taşır ve expiresAt zamanında kapanır.

Belgeler ne kadar süre erişilebilir

PDFgine belge üretir ve teslim eder; üretilen belgeyi saklamak sizin tercihinizdir. Ürün yalnız kendi girdilerini (şablonlar, marka varlıkları) ve geçici çıktıları tutar. Her çıktı, istekte seçtiğiniz süre kadar durur — accessProfile: short 24 saat (varsayılan), standard 7 gün, extended 30 gün (7 ve 30 gün Go ve üzeri planlarda), quarter 90 gün (Max planında). Paylaşım bağlantısı bu süre boyunca açıktır; üretim belgesi (/render, /documents/render) bu süre boyunca API’den yeniden indirilebilir. Süre dolunca indirme 410 döner ve çıktı en geç 24 saat içinde silinir; üretim kaydı, sayfa sayısı ve kullanım bilgisi kalır. Belgeyi kalıcı olarak saklamak istiyorsanız üretimden hemen sonra kendi sisteminize alın.

Doksan günlük bağlantılar

Standart ve uzatılmış profillerin yanında, bağlantıyı 90 gün açık tutan bir quarter profili var; karşı tarafın bir çeyrek boyunca yeniden açabilmesi gereken sözleşmeler için. En üst planda açık; her plan kullanabileceği profilleri kendi plan yetkilerinde görüyor.

Bağlantıyı erken kapatmak

Paylaşım bağlantısı normalde expiresAt anında kapanır. Belgenin artık görülmemesi gerekiyorsa iptal edin: yanıt 204 olur ve bağlantı anında çalışmayı bırakır.

cURL 
curl -i -X POST https://api.pdfgine.com/api/v1/previews/prv_481fac83d9f14a4493021eb128d0876b/revoke \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

HTTP/1.1 204 No Content

Sık takılınan yerler

  • Önizleme oluşturmak 200 değil 201 döner; iptal ise gövdesiz 204. Her yanıtı JSON olarak çözümleyen bir istemci iptalde hata verir.
  • accessProfile bağlantının ne kadar yaşayacağını belirler ve uzun profiller uygun planı ister. Planın içermediği quarter istendiğinde istek sessizce kısaltılmaz, reddedilir.
  • downloads içindeki indirme adresleri imza ve son kullanma taşır. Bu adresleri değil previewId'yi saklayın; saklanan adres süresi dolduğunda çalışmaz.
  • İptal bağlantıyı kapatır, belgeyi değil. Dosya hâlâ sizindir ve saklama süresi boyunca API üzerinden indirilebilir.
  • Önizleme, üretim kotasından değil önizleme sayfalarından düşer. Aynı belgeyi /render ile yeniden üretmek ayrı ve faturalanan bir sayfa sayısıdır.