Buku resep Connect
Buku resep Connect
Bagian berjudul “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 nextpdf/serverdocs/public/ dan diagregasi di sini. Hingga sebuah halaman tersedia, tautannya adalah referensi ke depan.
| Resep | tingkat | Ruang lingkup |
|---|---|---|
hello-world (direncanakan di upstream) | Core | Panggilan Connect pertama: buat, tambahkan konten, dan keluarkan |
multi-page (direncanakan di upstream) | Core | Dokumen multi-halaman melalui Connect |
image-embedding (direncanakan di upstream) | Core | Sematkan gambar melalui Connect |
html-table (direncanakan di upstream) | Core | Render tabel HTML melalui Connect |
font-typography (direncanakan di upstream) | Core | Fon dan tipografi melalui Connect |
exception-aware (direncanakan di upstream) | Core | Pemanggilan alat yang sadar exception |
environment-diagnostics (direncanakan di upstream) | Core | Alat diagnostik lingkungan |
layout-inspection (direncanakan di upstream) | Core | Periksa tata letak tanpa rendering |
worker-safe (direncanakan di upstream) | Core | Penggunaan batch yang aman untuk worker |
output-approval (direncanakan di upstream) | Core | Gerbang keluaran dengan campur tangan manusia (human-in-the-loop) |
event-hooks (direncanakan di upstream) | Core | Hook peristiwa siklus hidup |
fill-pdf-form (direncanakan di upstream) | Pro | Isi formulir PDF melalui Connect |
extract-text-content (direncanakan di upstream) | Pro | Ekstrak konten teks melalui Connect |
digital-signature (direncanakan di upstream) | Pro | Tanda tangani PDF (PAdES B-B dan B-T) melalui Connect |
accessibility-check (direncanakan di upstream) | Pro | Pemeriksaan aksesibilitas PDF/UA |
pii-redaction (direncanakan di upstream) | Enterprise | Hapus data pribadi yang terdeteksi dari lapisan teks (bersifat destruktif) |
aria-tagged-pdf (direncanakan di upstream) | Pro | Petakan peran landmark ARIA ke struktur bertanda |
figure-caption (direncanakan di upstream) | Pro | Figure yang aksesibel dengan Caption bersarang |
aria-noteref-pattern (direncanakan di upstream) | Pro | Pola referensi catatan kaki dan isinya |
compliance-check (direncanakan di upstream) | Enterprise | Jalankan pemeriksaan terhadap standar bernama |
forensic-analysis (direncanakan di upstream) | Enterprise | Analisis forensik atas PDF yang ditandatangani |
ltv-health-check (direncanakan di upstream) | Enterprise | Pemeriksaan kesehatan LTV (B-LT/B-LTA, khusus Enterprise) |
batch-compliance (direncanakan di upstream) | Enterprise | Pemeriksaan standar secara batch |
ai-ready-certification (direncanakan di upstream) | Enterprise | Pemeriksaan kesiapan AI (bukan sertifikasi) |
page-artifacts (direncanakan di upstream) | Enterprise | Tandai elemen tepi paginasi sebagai artifact |
conformance-mode (direncanakan di upstream) | Enterprise | Pilih mode konformansi (ditujukan agar konform; validatorlah yang memutuskan) |
cjk-vertical-writing (direncanakan di upstream) | Enterprise | Metrik penulisan vertikal CJK |
opentelemetry (direncanakan di upstream) | Core | Amati Connect dengan OpenTelemetry |
tagged-pdf-tutorial (direncanakan di upstream) | 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.