NextPDF Connect ile çok sayfalı belge oluşturma

Bir bakışta

NextPDF Connect ile çok sayfalı bir belge oluşturun. add_page, belgenin varsayılan geometrisini devralan veya kendi yönelimini belirleyen bir sayfa ekler. Her add_page çağrısının ardından imleç, yeni sayfadaki sol üst kenar boşluğuna sıfırlanır. Bu işlemde dört Core aracı kullanırsınız: create_pdf, add_text, add_page ve output_pdf.

Kurulum

composer require nextpdf/server

Bir taşıma katmanı bağlayın: Model Context Protocol (MCP) stdio, REST veya gRPC. Lisanslı bir katman gerekmez.

Kavramsal genel bakış

Belge, bir sayfa ağacı kullanır. Her sayfaya bu ağaç üzerinden erişirsiniz (ISO 32000-2 §7.7.3). Bir sayfanın, görünür alanı tanımlayan ortam kutusu (media box) dâhil olmak üzere kendi geometri öznitelikleri vardır (ISO 32000-2 §7.7.3.3). create_pdf ilk sayfayı otomatik olarak oluşturur; add_page ise ek sayfaların her birini ekler. Belge varsayılanını devralmak için page_size/orientation değerini belirtmeyin. A4 sayfasını 297×210 mm yapmak için orientation: "landscape" değerini ayarlayın.

API yüzeyi

Araç	Rol	Risk katmanı
create_pdf	Oturumu açar ve ilk sayfayı oluşturur	Güvenli
add_text	İmleç konumuna metin yazar	Dikkat
add_page	Bir sayfa ekler (devralır veya geçersiz kılar)	Dikkat
output_pdf	PDF’i işler ve döndürür	Onay Gerekli / İnceleme (base64)

Araç adları, kayıt protokolündeki adlardır. Araç kataloğu kayıtların başvuru kaynağıdır. Kullanabileceğiniz araçlar, kurulu katmana bağlıdır.

Kod örneği — hızlı başlangıç

Akış şu şekildedir:

1. create_pdf (A4 dikey, başlık, yazar) → document_id.
2. add_text (başlık, büyük yazı tipi, ortalanmış), ardından add_text (giriş paragrafı, gövde yazı tipi).
3. add_page çağrısını yalnızca document_id ile yapın → A4 dikey devralınır. Yeni page_number döndürülür ve imleç sıfırlanır.
4. add_text ile 2. sayfadaki bölüm başlığı ve gövde için metin yazın.
5. add_page çağrısını orientation: "landscape" ile yapın → geniş bir A4 sayfası.
6. add_text ile geniş içerik metnini yazın.
7. output_pdf → base64.

Kod örneği — üretim

Her yanıtı doğrulayın. add_page sonrasında içerik yeni sayfanın en üstünden başlar. İmlecin sıfırlanması bir hata değil, amaçlanan davranıştır. İçeriğin daha sonraki bir sayfaya akıp akmadığını anlamak için position.page değerini add_text yanıtlarından izleyin. output_pdf çağrısını tam olarak bir kez yapın, ardından document_id değerini atın.

Sınır durumları ve tuzaklar

• İmlecin sıfırlanması. add_page sonrasında imleç, yeni sayfanın sol üst kenar boşluğunda durur. İmlecin önceki sayfadan devam edeceğini beklemek yaygın bir yanılgıdır.
• Zorunlu document_id. create_pdf dışındaki her araç, document_id değerini gerektirir. Bunu belirtmemek bir hatadır.
• Geçersiz yönelim. Yalnızca "portrait" ve "landscape" geçerlidir.
• Çıktıdan sonra düzenleme. Oturum artık var olmadığından, output_pdf çağrısından sonra destroy: true ile içerik ekleme başarısız olur.

Performans

Çok sayfalı bir metin belgesi sayfa bütçesi içinde kalır ve çıktı birkaç KB boyutundadır. Profil structural türündedir: fragman (trailer) /ID değeri ile zaman damgaları çalıştırmalar arasında kararlı değildir.

Güvenlik notları

Base64 modunun yan etkisi yoktur. Dosya çıktısı onay kapısına tabidir; HITL bölümüne bakın. document_id, opak bir tanıtıcıdır. Bunu eşzamanlı istekler arasında paylaşmayın.

Uygunluk

İfade	Belirtim	Madde	reference_id
Sayfalara sayfa ağacı üzerinden erişilir.	ISO 32000-2	§7.7.3
Bir sayfa nesnesi kendi geometri özniteliklerini tanımlar.	ISO 32000-2	§7.7.3.3

Ticari bağlam

Geçerli değil — tüm araçlar Core kapsamındadır.

Taşıma kullanılabilirliği

Taşıma	Kullanılabilir	Notlar
MCP (stdio)	Evet	tools/call, araç başına çağrı.
REST	Evet	Araç başına bir işlem.
gRPC	Evet	Araç başına tekli (unary) çağrı.

HITL risk katmanı

create_pdf Güvenli katmanındadır; add_text ve add_page Dikkat katmanındadır; output_pdf Onay Gerekli katmanındadır ve base64 modunda İnceleme düzeyine indirilir. Dosya çıktısı Onay Gerekli olarak kalır. output-approval ve HITL risk katmanları bölümlerine bakın.

Onay kapısı JSON zarfı

Bu sayfadaki base64 çıktısı:

{ "allowed": true }

Sorgu formu output-approval bölümünde gösterilir.

Ayrıca bkz.

• Merhaba dünya
• Yerleşim incelemesi
• Araç kataloğu