Connect tarif kitabı

Tarifler / kılavuzlar, üst akış depoları yayınladıkça burada yer alır. Bu sayfa, kaynak depolarda (nextpdf, nextpdf-Laravel, nextpdf-Symfony ve diğer ekosistem paketleri) yazılan içerik için bir yönlendirme dizini görevi görür. Bugün mevcut belgeler için bkz. Insider_ (35 makale, 17 yerel ayarın tümü) veya Bir entegrasyon seçin sayfasına bakın.

NextPDF 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

Bir 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

Her 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ı

Her 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/server deposunun docs/public/ ağacında yazılır ve toplayıcı aracılığıyla bu siteye yayımlanır.

Tarif	Katman	Kapsam
hello-world	Core	İlk Connect çağrısı: oluşturma, içerik ekleme ve çıktı
multi-page	Core	Connect üzerinden çok sayfalı belge
image-embedding	Core	Connect üzerinden bir görseli gömme
html-table	Core	Connect üzerinden bir HTML tablosunu işleme
font-typography	Core	Connect üzerinden yazı tipleri ve tipografi
exception-aware	Core	İstisnaların farkında olan araç çağrıları
environment-diagnostics	Core	Ortam tanılama araçları
layout-inspection	Core	İşleme yapmadan yerleşimi inceleme
worker-safe	Core	Worker için güvenli toplu kullanım
batch-pdf-generation-with-progress-tracking	Core	Asenkron ilerleme takibiyle PDF’leri toplu üretme
rest-invoice-end-to-end	Core	REST üzerinden tek fatura: gönderme, sorgulama, indirme, yerelde doğrulama
output-approval	Core	İnsanın döngüde olduğu çıktı kapısı
mcp-agent-session	Core	Onay gidiş dönüşünü içeren, kaydedilmiş bir MCP ajan oturumu
event-hooks	Core	Yaşam döngüsü olay kancaları
fill-pdf-form	Pro	Connect üzerinden bir PDF formu doldurma
extract-text-content	Pro	Connect üzerinden metin içeriği çıkarma
digital-signature	Pro	Connect üzerinden bir PDF’i imzalama (PAdES B-B ve B-T)
accessibility-check	Pro	PDF/UA erişilebilirlik denetimi
pii-redaction	Enterprise	Algılanan kişisel verileri metin katmanından kaldırma (geri dönüşü olmayan)
aria-tagged-pdf	Pro	ARIA dönüm noktası rollerini etiketli yapıyla eşleme
figure-caption	Pro	İç içe Caption bulunan erişilebilir Figure
aria-noteref-pattern	Pro	Dipnot referansı ve gövde deseni
compliance-check	Enterprise	Adlandırılmış bir standart denetimi çalıştırma
forensic-analysis	Enterprise	İmzalı bir PDF’nin adli analizi
ltv-health-check	Enterprise	LTV sağlık denetimi (B-LT/B-LTA, yalnızca Enterprise)
batch-compliance	Enterprise	Toplu standart denetimi
ai-ready-certification	Enterprise	AI hazırlık denetimi (bir sertifikasyon değildir)
page-artifacts	Enterprise	Sayfalandırma çerçevesini yapay öğe olarak işaretleme
conformance-mode	Enterprise	Bir uygunluk modu seçme (uygun olması amaçlanır; bir doğrulayıcı karar verir)
cjk-vertical-writing	Enterprise	CJK dikey yazım metrikleri
opentelemetry	Core	Connect’i OpenTelemetry ile gözlemleme
tagged-pdf-tutorial	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ı

Bazı 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

• 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ı.