Connect tarif kitabı
Connect tarif kitabı
“Connect tarif kitabı” başlıklı bölümNextPDF Connect, NextPDF motorunu Model Context Protocol (MCP), Representational State Transfer (REST) API ve bir gRPC hizmeti üzerinden uzaktan çağrı yapan istemcilere ve yapay zeka (AI) sistemlerine açar. Connect tarif kitabı, bu yüzeye ait görev tariflerini bir araya getirir; bu sayfa da bu tariflerin dizinidir. Her tarifin slug değerini, ait olduğu katmanı ve geçerli taşıma sınırını kaydeder. Bu sayfa bir dizin olduğundan, hiçbir tarif hakkında davranışsal bir iddiada bulunmaz. Her tarif sayfası, nextpdf/server deposundaki docs/public/ altında yazılır, kendi iddialarını taşır ve kaynak kökeni korunarak toplayıcı tarafından bu siteye çekilir.
Her Connect tarifinin uyduğu sözleşmeyi görmek için Tarif kuralları sayfasını okuyun. Ekosistem genelindeki entegrasyon bağlamı için Entegrasyon tarif kitabı sayfasını okuyun.
Katmanın çalıştırabileceklerinizi nasıl etkilediği
“Katmanın çalıştırabileceklerinizi nasıl etkilediği” başlıklı bölümBir Connect dağıtımı, araç kümesini başlatma anında hesaplar; küme önceden sabit değildir. Sunucunun araç kaydı, çekirdek araçları her zaman kaydeder. Ardından Pro ve Enterprise sağlayıcılarını class_exists() ile denetler ve bu sağlayıcıların araçlarını yalnızca sunucuyla birlikte nextpdf/premium kurulduğunda kaydeder. Bir Pro veya Enterprise aracına bağımlı olan bir tarif, yalnızca o aracın çözümlenebildiği bir dağıtımda çalışır. Yalnızca açık kaynaklı bir kurulumda bu araç bulunmaz ve çağrı, sessizce bozulmak yerine bilinmeyen araç hatası döndürür. Her tarif kendi katmanını belirtir ve bu dizin, bir dağıtımın neyi desteklediğini bir bakışta görebilmeniz için tarifleri katmana göre gruplandırır.
Toplam araç sayısı, dağıtımın çalışma zamanı özelliğidir. Bu dizindeki hiçbir tarif ve hiçbir satır, sabit bir sayı ileri sürmez. Güncel kayıt kataloğu, her tarifin bağlantı verdiği sunucunun kendi araç kataloğudur.
Taşıma ve hata modeli
“Taşıma ve hata modeli” başlıklı bölümHer tarifi üç taşıma üzerinden de aynı şekilde çağırırsınız: bir MCP tools/call, REST araç uç noktası veya gRPC hizmeti. Bunlar tek bir araç yürütücüsünü paylaşır. Uzak bir hizmete Hypertext Transfer Protocol (HTTP) üzerinden ulaşan tarifler, taşıma hatası ile başarısız HTTP durumunu ayrı durumlar olarak ele alır. Bir PSR-18 istemcisi, PSR-18 §4’te açıklandığı gibi, yalnızca isteği hiç gönderemediğinde türlenmiş bir istemci istisnası fırlatır. Bir 4xx veya 5xx yanıtı farklıdır. Bu, PSR-18 §4’te açıklandığı gibi, istisna değil çağıranın incelediği normal bir dönüş değeridir.
Tarif slug haritası
“Tarif slug haritası” başlıklı bölümHer tarif /cookbook/connect/<recipe>/ konumunda bulunur. Tablo, slug değerini, tarifin değerlendirildiği katmanı ve tek satırlık kapsamını kaydeder. Tarif sayfaları nextpdf/serverdocs/public/ içinde yazılır ve burada toplanır. Bir sayfa yayınlanana kadar bağlantısı ileriye dönük bir referanstır.
| Tarif | Katman | Kapsam |
|---|---|---|
hello-world (üst akışta planlandı) | Core | İlk Connect çağrısı: oluşturma, içerik ekleme ve çıktı |
multi-page (üst akışta planlandı) | Core | Connect üzerinden çok sayfalı belge |
image-embedding (üst akışta planlandı) | Core | Connect üzerinden bir görseli gömme |
html-table (üst akışta planlandı) | Core | Connect üzerinden bir HTML tablosunu işleme |
font-typography (üst akışta planlandı) | Core | Connect üzerinden yazı tipleri ve tipografi |
exception-aware (üst akışta planlandı) | Core | İstisnaların farkında olan araç çağrıları |
environment-diagnostics (üst akışta planlandı) | Core | Ortam tanılama araçları |
layout-inspection (üst akışta planlandı) | Core | İşleme yapmadan yerleşimi inceleme |
worker-safe (üst akışta planlandı) | Core | Worker için güvenli toplu kullanım |
output-approval (üst akışta planlandı) | Core | İnsanın döngüde olduğu çıktı kapısı |
event-hooks (üst akışta planlandı) | Core | Yaşam döngüsü olay kancaları |
fill-pdf-form (üst akışta planlandı) | Pro | Connect üzerinden bir PDF formu doldurma |
extract-text-content (üst akışta planlandı) | Pro | Connect üzerinden metin içeriği çıkarma |
digital-signature (üst akışta planlandı) | Pro | Connect üzerinden bir PDF’i imzalama (PAdES B-B ve B-T) |
accessibility-check (üst akışta planlandı) | Pro | PDF/UA erişilebilirlik denetimi |
pii-redaction (üst akışta planlandı) | Enterprise | Algılanan kişisel verileri metin katmanından kaldırma (geri dönüşü olmayan) |
aria-tagged-pdf (üst akışta planlandı) | Pro | ARIA dönüm noktası rollerini etiketli yapıyla eşleme |
figure-caption (üst akışta planlandı) | Pro | İç içe Caption bulunan erişilebilir Figure |
aria-noteref-pattern (üst akışta planlandı) | Pro | Dipnot referansı ve gövde deseni |
compliance-check (üst akışta planlandı) | Enterprise | Adlandırılmış bir standart denetimi çalıştırma |
forensic-analysis (üst akışta planlandı) | Enterprise | İmzalı bir PDF’nin adli analizi |
ltv-health-check (üst akışta planlandı) | Enterprise | LTV sağlık denetimi (B-LT/B-LTA, yalnızca Enterprise) |
batch-compliance (üst akışta planlandı) | Enterprise | Toplu standart denetimi |
ai-ready-certification (üst akışta planlandı) | Enterprise | AI hazırlık denetimi (bir sertifikasyon değildir) |
page-artifacts (üst akışta planlandı) | Enterprise | Sayfalandırma çerçevesini yapay öğe olarak işaretleme |
conformance-mode (üst akışta planlandı) | Enterprise | Bir uygunluk modu seçme (uygun olması amaçlanır; bir doğrulayıcı karar verir) |
cjk-vertical-writing (üst akışta planlandı) | Enterprise | CJK dikey yazım metrikleri |
opentelemetry (üst akışta planlandı) | Core | Connect’i OpenTelemetry ile gözlemleme |
tagged-pdf-tutorial (üst akışta planlandı) | Core | Etiketli PDF öğreticisi (uygun olması amaçlanır; veraPDF karar verir) |
Slug, tarifin amacını sonunda tek bir eğik çizgiyle kebab-case biçiminde ifade eder: sayısal önek, sürüm numarası ve dosya uzantısı yoktur. Bir tarif slug değeri yayımlandıktan sonra değişmez ve taşınan bir slug için yönlendirme bulunur.
Uygunluk ve sertifikasyon sınırı
“Uygunluk ve sertifikasyon sınırı” başlıklı bölümBazı tarifler standartlara değinir (PDF/UA-2, PDF/A-4, PAdES). Connect tarif kitabı, bir standarda yönelik desteği yalnızca destek olarak ele alır; bunu asla uygunluk veya sertifikasyon olarak değerlendirmez. Motor, uygun olması amaçlanan çıktı üretir ve bağımsız bir doğrulayıcı (örneğin veraPDF) uygunluğu belirler. AI hazırlık tarifi, bir sertifikasyon değil, hazırlık denetimidir. LTV tarifindeki uzun vadeli doğrulama malzemesi, yalnızca Enterprise’a özgü bir yetenektir. Bir belgede bulunması, belgenin taşıdığı bir yetenektir; süresiz imza geçerliliğinin garantisi değildir. İlgili her tarif, bu sınırları tam olarak yeniden belirtir. Bu dizin, bunları burada yeniden temellendirmek yerine yalnızca var olduklarını belirtir ve nereden türetildiklerine işaret eder.
Ayrıca bakınız
“Ayrıca bakınız” başlıklı bölüm- Tarif kuralları — her Connect tarifinin uyduğu sözleşme.
- Entegrasyon tarif kitabı — Connect’in ağ hizmeti olarak yer aldığı, ekosistem çapındaki paket ve entegrasyon referansı.