Connect-cookbook
Connect-cookbook
Sectie met titel “Connect-cookbook”NextPDF Connect maakt de NextPDF-engine beschikbaar voor externe aanroepers en systemen voor kunstmatige intelligentie (AI) via het Model Context Protocol (MCP), een Representational State Transfer (REST) API en een gRPC-service. Het Connect-cookbook bundelt de taakrecipes voor dat oppervlak; deze pagina is de index. De index vermeldt elke recipe-slug, het niveau waaronder die valt en de transportgrens die van toepassing is. Omdat deze pagina een index is, legt zij geen gedragsclaim vast voor afzonderlijke recipes. Elke recipepagina wordt geschreven in de nextpdf/server-repository onder docs/public/, bevat zijn eigen claims en wordt door de aggregator in deze site opgenomen met zijn bronherkomst intact.
Lees Recipe-conventies voor het contract waaraan elk Connect-recipe voldoet. Voor het volledige integratielandschap van het ecosysteem lees je het Integratie-cookbook.
Hoe het niveau bepaalt wat je kunt uitvoeren
Sectie met titel “Hoe het niveau bepaalt wat je kunt uitvoeren”Een Connect-deployment berekent zijn toolset bij het opstarten; deze ligt niet vooraf vast. Het toolregister van de server registreert altijd de coretools. Daarna detecteert het de Pro- en Enterprise-providers met class_exists() en registreert het hun tools alleen wanneer nextpdf/premium naast de server is geïnstalleerd. Een recipe dat afhankelijk is van een Pro- of Enterprise-tool draait alleen op een deployment waar die tool is opgelost. In een installatie met alleen open source ontbreekt de tool en geeft de aanroep een unknown-tool-fout terug in plaats van stilzwijgend te degraderen. Elk recipe vermeldt zijn niveau en deze index groepeert recipes per niveau, zodat je in één oogopslag ziet wat een deployment ondersteunt.
Het totale aantal tools is een runtime-eigenschap van de deployment. Geen enkel recipe en geen enkele rij in deze index legt een vast aantal vast. De gezaghebbende catalogus is de eigen toolcatalogus van de server, waarnaar elk recipe verwijst.
Transport- en foutmodel
Sectie met titel “Transport- en foutmodel”Je roept elk recipe via alle drie de transporten op dezelfde manier aan: een MCP tools/call, het REST-toolendpoint of de gRPC-service. Ze delen één tool-executor. Recipes die een externe service bereiken via het Hypertext Transfer Protocol (HTTP) behandelen een transportfout en een HTTP-status zonder succes als afzonderlijke gevallen. Een PSR-18-client werpt alleen een getypeerde client-exception op wanneer hij het verzoek in het geheel niet kan verzenden, zoals beschreven in PSR-18 §4. Een 4xx- of 5xx-respons is anders. Het is een normale retourwaarde die de aanroeper inspecteert, geen exception, zoals beschreven in PSR-18 §4.
De recipe-slugkaart
Sectie met titel “De recipe-slugkaart”Elk recipe staat op /cookbook/connect/<recipe>/. De tabel vermeldt de slug, het niveau waaronder het recipe wordt gelezen en een scope van één regel. De recipepagina’s worden geschreven in nextpdf/serverdocs/public/ en worden hier geaggregeerd. Totdat een pagina verschijnt, is de bijbehorende link een vooruitverwijzing.
| Recipe | Niveau | Scope |
|---|---|---|
hello-world (gepland upstream) | Core | Eerste Connect-aanroep: aanmaken, inhoud toevoegen, uitvoeren |
multi-page (gepland upstream) | Core | Document met meerdere pagina’s via Connect |
image-embedding (gepland upstream) | Core | Een afbeelding insluiten via Connect |
html-table (gepland upstream) | Core | Een HTML-tabel weergeven via Connect |
font-typography (gepland upstream) | Core | Lettertypen en typografie via Connect |
exception-aware (gepland upstream) | Core | Exception-bewuste toolaanroepen |
environment-diagnostics (gepland upstream) | Core | Tools voor omgevingsdiagnostiek |
layout-inspection (gepland upstream) | Core | Lay-out inspecteren zonder weergave |
worker-safe (gepland upstream) | Core | Worker-veilig batchgebruik |
output-approval (gepland upstream) | Core | De human-in-the-loop-uitvoerpoort |
event-hooks (gepland upstream) | Core | Hooks voor levenscyclusgebeurtenissen |
fill-pdf-form (gepland upstream) | Pro | Een PDF-formulier invullen via Connect |
extract-text-content (gepland upstream) | Pro | Tekstinhoud extraheren via Connect |
digital-signature (gepland upstream) | Pro | Een PDF ondertekenen (PAdES B-B en B-T) via Connect |
accessibility-check (gepland upstream) | Pro | PDF/UA-toegankelijkheidscontrole |
pii-redaction (gepland upstream) | Enterprise | Gedetecteerde persoonsgegevens uit de tekstlaag verwijderen (destructief) |
aria-tagged-pdf (gepland upstream) | Pro | ARIA-landmarkrollen toewijzen aan getagde structuur |
figure-caption (gepland upstream) | Pro | Toegankelijke Figure met een geneste Caption |
aria-noteref-pattern (gepland upstream) | Pro | Patroon voor voetnootverwijzing en -tekst |
compliance-check (gepland upstream) | Enterprise | Een controle op een benoemde standaard uitvoeren |
forensic-analysis (gepland upstream) | Enterprise | Forensische analyse van een ondertekende PDF |
ltv-health-check (gepland upstream) | Enterprise | LTV-statuscontrole (B-LT/B-LTA, alleen Enterprise) |
batch-compliance (gepland upstream) | Enterprise | Batchcontrole op standaarden |
ai-ready-certification (gepland upstream) | Enterprise | AI-gereedheidscontrole (geen certificering) |
page-artifacts (gepland upstream) | Enterprise | Pagineringselementen markeren als artefacten |
conformance-mode (gepland upstream) | Enterprise | Een conformiteitsmodus selecteren (bedoeld om te voldoen; een validator beslist) |
cjk-vertical-writing (gepland upstream) | Enterprise | Metrieken voor verticaal CJK-schrift |
opentelemetry (gepland upstream) | Core | Connect observeren met OpenTelemetry |
tagged-pdf-tutorial (gepland upstream) | Core | Tutorial voor getagde PDF (bedoeld om te voldoen; veraPDF beslist) |
De slug drukt de bedoeling van het recipe uit in kebab-case met één afsluitende schuine streep: geen numeriek voorvoegsel, geen versienummer en geen bestandsextensie. Een recipe-slug verandert niet na publicatie en een verplaatste slug krijgt een redirect mee.
Conformiteits- en certificeringsgrens
Sectie met titel “Conformiteits- en certificeringsgrens”Verschillende recipes raken aan standaarden (PDF/UA-2, PDF/A-4, PAdES). Het Connect-cookbook beschrijft ondersteuning voor een standaard als ondersteuning, nooit als conformiteit of certificering. De engine produceert uitvoer die bedoeld is om te voldoen en een onafhankelijke validator (bijvoorbeeld veraPDF) bepaalt de conformiteit. Het AI-gereedheidsrecipe is een gereedheidscontrole, geen certificering. Het long-term-validation-materiaal van het LTV-recipe is een mogelijkheid die alleen in Enterprise beschikbaar is. De aanwezigheid ervan in een document betekent dat het document die mogelijkheid meedraagt, geen garantie voor onbeperkte geldigheid van de handtekening. Elk betrokken recipe herhaalt deze grenzen volledig. Deze index vermeldt alleen dat deze grenzen bestaan en verwijst naar de plek waar ze worden afgeleid, in plaats van ze hier opnieuw af te leiden.
Zie ook
Sectie met titel “Zie ook”- Recipe-conventies — het contract waaraan elk Connect-recipe voldoet.
- Integratie-cookbook — de ecosysteembrede referentie voor pakketten en integraties, waarin Connect de netwerkservice is.