Buku resep Connect
NextPDF Connect mengekspos mesin NextPDF ke pemanggil jarak jauh dan sistem kecerdasan buatan (AI) melalui Model Context Protocol (MCP), API Representational State Transfer (REST), dan layanan gRPC. Buku resep Connect mengumpulkan resep tugas untuk permukaan tersebut, dan halaman ini berfungsi sebagai indeksnya. Halaman ini mencatat slug setiap resep, tingkat (tier) tempatnya berada, dan batas transport yang berlaku. Karena halaman ini hanya berupa indeks, halaman ini tidak membuat klaim perilaku tentang resep apa pun. Setiap halaman resep ditulis di dalam repositori nextpdf/server di bawah docs/public/, memiliki klaimnya sendiri, dan ditarik ke situs ini oleh agregator dengan provenans sumber yang tetap utuh.
Untuk melihat kontrak yang diikuti setiap resep Connect, baca Konvensi resep. Untuk gambaran menyeluruh tentang lanskap integrasi ekosistem, baca Buku resep integrasi.
Cara tingkat (tier) memengaruhi hal yang dapat Anda jalankan
Bagian berjudul “Cara tingkat (tier) memengaruhi hal yang dapat Anda jalankan”Sebuah deployment Connect menghitung kumpulan alatnya saat boot; kumpulan tersebut tidak ditetapkan sebelumnya. Registri alat pada server selalu mendaftarkan alat inti. Setelah itu, server memeriksa penyedia Pro dan Enterprise dengan class_exists(), lalu mendaftarkan alat-alatnya hanya ketika nextpdf/premium dipasang bersama server. Resep yang bergantung pada alat Pro atau Enterprise hanya berjalan pada deployment tempat alat tersebut berhasil di-resolve. Pada instalasi yang hanya open source, alat tersebut tidak tersedia, dan pemanggilan mengembalikan galat alat-tak-dikenal alih-alih melakukan fallback secara diam-diam. Setiap resep menyatakan tingkatnya sendiri, dan indeks ini mengelompokkan resep berdasarkan tingkat sehingga Anda dapat melihat apa yang didukung sebuah deployment secara sekilas.
Jumlah total alat merupakan properti runtime dari deployment. Tidak ada resep ataupun baris dalam indeks ini yang menyatakan angka tetap. Katalog resminya adalah katalog alat milik server itu sendiri, yang ditautkan oleh setiap resep.
Model transport dan penanganan galat
Bagian berjudul “Model transport dan penanganan galat”Anda memanggil setiap resep dengan cara yang sama melalui ketiga transport: sebuah tools/call MCP, endpoint alat REST, atau layanan gRPC. Ketiganya berbagi satu eksekutor alat. Resep yang mengakses layanan jarak jauh melalui Hypertext Transfer Protocol (HTTP) memperlakukan kegagalan transport dan status HTTP yang tidak sukses sebagai kasus yang terpisah. Klien PSR-18 memunculkan client exception bertipe hanya ketika klien sama sekali tidak dapat mengirim permintaan, sebagaimana dijelaskan dalam PSR-18 §4. Respons 4xx atau 5xx berbeda. Respons tersebut merupakan nilai kembalian normal yang diperiksa oleh pemanggil, bukan sebuah exception, sebagaimana dijelaskan dalam PSR-18 §4.
Peta slug resep
Bagian berjudul “Peta slug resep”Setiap resep berada di /cookbook/connect/<recipe>/. Tabel ini mencatat slug, tingkat (tier) tempat resep berada, dan ringkasan ruang lingkup satu baris. Halaman resep ditulis di dalam direktori docs/public/ pada repositori nextpdf/server dan dipublikasikan ke situs ini melalui agregator.
| Resep | tingkat | Ruang lingkup |
|---|---|---|
hello-world | Core | Panggilan Connect pertama: buat, tambahkan konten, dan keluarkan |
multi-page | Core | Dokumen multi-halaman melalui Connect |
image-embedding | Core | Sematkan gambar melalui Connect |
html-table | Core | Render tabel HTML melalui Connect |
font-typography | Core | Fon dan tipografi melalui Connect |
exception-aware | Core | Pemanggilan alat yang sadar exception |
environment-diagnostics | Core | Alat diagnostik lingkungan |
layout-inspection | Core | Periksa tata letak tanpa rendering |
worker-safe | Core | Penggunaan batch yang aman untuk worker |
batch-pdf-generation-with-progress-tracking | Core | Hasilkan PDF secara batch dengan pelacakan progres asinkron |
rest-invoice-end-to-end | Core | Satu faktur melalui REST: kirim, polling, unduh, verifikasi secara lokal |
output-approval | Core | Gerbang keluaran dengan campur tangan manusia (human-in-the-loop) |
mcp-agent-session | Core | Sesi agen MCP yang terekam dengan alur bolak-balik persetujuan |
event-hooks | Core | Hook peristiwa siklus hidup |
fill-pdf-form | Pro | Isi formulir PDF melalui Connect |
extract-text-content | Pro | Ekstrak konten teks melalui Connect |
digital-signature | Pro | Tanda tangani PDF (PAdES B-B dan B-T) melalui Connect |
accessibility-check | Pro | Pemeriksaan aksesibilitas PDF/UA |
pii-redaction | Enterprise | Hapus data pribadi yang terdeteksi dari lapisan teks (bersifat destruktif) |
aria-tagged-pdf | Pro | Petakan peran landmark ARIA ke struktur bertanda |
figure-caption | Pro | Figure yang aksesibel dengan Caption bersarang |
aria-noteref-pattern | Pro | Pola referensi catatan kaki dan isinya |
compliance-check | Enterprise | Jalankan pemeriksaan terhadap standar bernama |
forensic-analysis | Enterprise | Analisis forensik atas PDF yang ditandatangani |
ltv-health-check | Enterprise | Pemeriksaan kesehatan LTV (B-LT/B-LTA, khusus Enterprise) |
batch-compliance | Enterprise | Pemeriksaan standar secara batch |
ai-ready-certification | Enterprise | Pemeriksaan kesiapan AI (bukan sertifikasi) |
page-artifacts | Enterprise | Tandai elemen tepi paginasi sebagai artifact |
conformance-mode | Enterprise | Pilih mode konformansi (ditujukan agar konform; validatorlah yang memutuskan) |
cjk-vertical-writing | Enterprise | Metrik penulisan vertikal CJK |
opentelemetry | Core | Amati Connect dengan OpenTelemetry |
tagged-pdf-tutorial | Core | Tutorial PDF bertanda (ditujukan untuk konform; veraPDF yang memutuskan) |
Slug menyatakan maksud resep dalam kebab-case dengan satu garis miring penutup: tanpa awalan numerik, tanpa nomor versi, dan tanpa ekstensi berkas. Slug resep tidak berubah setelah dipublikasikan; slug yang dipindahkan membawa pengalihan (redirect).
Batas konformansi dan sertifikasi
Bagian berjudul “Batas konformansi dan sertifikasi”Beberapa resep merujuk pada standar (PDF/UA-2, PDF/A-4, PAdES). Buku resep Connect memperlakukan dukungan terhadap suatu standar hanya sebagai dukungan, tidak pernah sebagai konformansi atau sertifikasi. Mesin menghasilkan keluaran yang ditujukan agar konform, dan validator independen (misalnya veraPDF) yang menentukan konformansi. Resep kesiapan AI adalah pemeriksaan kesiapan, bukan sertifikasi. Materi validasi jangka panjang pada resep LTV merupakan kemampuan khusus Enterprise. Keberadaannya dalam sebuah dokumen adalah kemampuan yang dibawa dokumen tersebut, bukan jaminan keabsahan tanda tangan untuk waktu yang tidak terbatas. Setiap resep yang terdampak menegaskan kembali batas-batas ini secara lengkap. Indeks ini hanya mencatat bahwa batas-batas itu ada dan menunjuk ke tempat batas-batas itu dijabarkan, alih-alih menjabarkannya ulang di sini.
Lihat juga
Bagian berjudul “Lihat juga”- Konvensi resep — kontrak yang diikuti setiap resep Connect.
- Buku resep integrasi — referensi paket dan integrasi di seluruh ekosistem, dengan Connect sebagai layanan jaringan.