Membuat dokumen multihalaman dengan NextPDF Connect

Sekilas pandang

Buat dokumen dengan beberapa halaman menggunakan NextPDF Connect. add_page menambahkan halaman yang mewarisi geometri standar dokumen, atau menetapkan orientasinya sendiri. Setelah setiap add_page, kursor diatur ulang ke margin kiri atas pada halaman baru. Gunakan empat alat Core: create_pdf, add_text, add_page, dan output_pdf.

Pemasangan

composer require nextpdf/server

Ikatkan satu transport: Model Context Protocol (MCP) stdio, REST, atau gRPC. Anda tidak memerlukan tingkat berlisensi.

Tinjauan konseptual

Dokumen menggunakan pohon halaman. Setiap halaman diakses melalui pohon tersebut (ISO 32000-2 §7.7.3). Halaman memiliki atribut geometrinya sendiri, termasuk media box yang menentukan area yang terlihat (ISO 32000-2 §7.7.3.3). create_pdf membuat halaman pertama secara otomatis, dan add_page menambahkan setiap halaman tambahan. Jangan sertakan page_size/orientation untuk mewarisi nilai standar dokumen. Tetapkan orientation: "landscape" untuk membuat halaman A4 berukuran 297×210 mm.

Permukaan API

Alat	Peran	Tingkat risiko
`create_pdf`	Membuka sesi dan membuat halaman pertama	Aman
`add_text`	Menulis teks pada posisi kursor	Perhatian
`add_page`	Menambahkan halaman (mewarisi atau menimpa)	Perhatian
`output_pdf`	Merender dan mengembalikan PDF	Persetujuan Diperlukan / Tinjauan (base64)

Nama alat adalah nama di registry protokol. Katalog alat adalah sumber resmi. Alat yang tersedia bagi Anda bergantung pada tingkat yang terpasang.

Contoh kode — Mulai cepat

Alurnya:

create_pdf (A4 portrait, judul, penulis) → document_id.
add_text (judul, huruf besar, rata tengah), lalu add_text (paragraf pembuka, huruf isi).
add_page hanya dengan document_id → mewarisi A4 portrait. page_number yang baru dikembalikan dan kursor diatur ulang.
add_text untuk judul bagian dan isi pada halaman 2.
add_page dengan orientation: "landscape" → halaman A4 berorientasi lebar.
add_text untuk konten berformat lebar.
output_pdf → base64.

Contoh kode — Produksi

Validasi setiap respons. Setelah add_page, konten dimulai dari bagian atas halaman baru. Pengaturan ulang kursor adalah perilaku yang disengaja, bukan bug. Lacak position.page dari respons add_text untuk mendeteksi kapan konten sudah mengalir ke halaman berikutnya. Panggil output_pdf tepat satu kali, lalu buang document_id.

Kasus batas & jebakan

Pengaturan ulang kursor. Setelah add_page, kursor berada di margin kiri atas halaman baru. Kesalahan umum adalah mengharapkannya melanjutkan dari halaman sebelumnya.
document_id wajib. Setiap alat kecuali create_pdf memerlukan document_id. Menghilangkannya merupakan kesalahan.
Orientasi tidak valid. Hanya "portrait" dan "landscape" yang valid.
Menyunting setelah keluaran. Penambahan konten setelah output_pdf dengan destroy: true akan gagal, karena sesi sudah tidak ada.

Kinerja

Dokumen teks multihalaman tetap berada dalam batas anggaran halaman, dan keluarannya hanya beberapa KB. Profilnya adalah structural: /ID trailer dan stempel waktu tidak stabil di antara eksekusi.

Catatan keamanan

Mode base64 tidak memiliki efek samping. Keluaran berkas dibatasi oleh gerbang; lihat bagian human-in-the-loop (HITL). document_id adalah pegangan buram. Jangan membagikannya di antara permintaan yang berjalan bersamaan.

Kesesuaian

Pernyataan	Spesifikasi	Klausul	reference_id
Halaman diakses melalui pohon halaman.	ISO 32000-2	§7.7.3
Objek halaman menentukan atribut geometrinya sendiri.	ISO 32000-2	§7.7.3.3

Konteks komersial

Tidak berlaku — semua alat adalah Core.

Ketersediaan transport

Transport	Tersedia	Catatan
MCP (stdio)	Ya	`tools/call` per alat.
REST	Ya	Satu operasi per alat.
gRPC	Ya	Unary per alat.

Tingkat risiko HITL

create_pdf bersifat Aman; add_text dan add_page bersifat Perhatian; output_pdf bersifat Persetujuan Diperlukan, dan diturunkan menjadi Tinjauan dalam mode base64. Keluaran berkas tetap berstatus Persetujuan Diperlukan. Lihat output-approval dan tingkat risiko HITL.

Amplop JSON gerbang konfirmasi

Keluaran base64 di sini adalah:

{ "allowed": true }

Formulir tantangan ditampilkan di output-approval.