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 de nextpdf/server-repository onder docs/public/ en worden via de aggregator in deze site gepubliceerd.
| Recipe | Niveau | Scope |
|---|---|---|
hello-world | Core | Eerste Connect-aanroep: aanmaken, inhoud toevoegen, uitvoeren |
multi-page | Core | Document met meerdere pagina’s via Connect |
image-embedding | Core | Een afbeelding insluiten via Connect |
html-table | Core | Een HTML-tabel weergeven via Connect |
font-typography | Core | Lettertypen en typografie via Connect |
exception-aware | Core | Exception-bewuste toolaanroepen |
environment-diagnostics | Core | Tools voor omgevingsdiagnostiek |
layout-inspection | Core | Lay-out inspecteren zonder weergave |
worker-safe | Core | Worker-veilig batchgebruik |
batch-pdf-generation-with-progress-tracking | Core | PDF’s batchgewijs genereren met asynchrone voortgangsregistratie |
rest-invoice-end-to-end | Core | Eén factuur via REST: indienen, pollen, downloaden, lokaal verifiëren |
output-approval | Core | De human-in-the-loop-uitvoerpoort |
mcp-agent-session | Core | Een vastgelegde MCP-agentsessie met de goedkeuringsronde |
event-hooks | Core | Hooks voor levenscyclusgebeurtenissen |
fill-pdf-form | Pro | Een PDF-formulier invullen via Connect |
extract-text-content | Pro | Tekstinhoud extraheren via Connect |
digital-signature | Pro | Een PDF ondertekenen (PAdES B-B en B-T) via Connect |
accessibility-check | Pro | PDF/UA-toegankelijkheidscontrole |
pii-redaction | Enterprise | Gedetecteerde persoonsgegevens uit de tekstlaag verwijderen (destructief) |
aria-tagged-pdf | Pro | ARIA-landmarkrollen toewijzen aan getagde structuur |
figure-caption | Pro | Toegankelijke Figure met een geneste Caption |
aria-noteref-pattern | Pro | Patroon voor voetnootverwijzing en -tekst |
compliance-check | Enterprise | Een controle op een benoemde standaard uitvoeren |
forensic-analysis | Enterprise | Forensische analyse van een ondertekende PDF |
ltv-health-check | Enterprise | LTV-statuscontrole (B-LT/B-LTA, alleen Enterprise) |
batch-compliance | Enterprise | Batchcontrole op standaarden |
ai-ready-certification | Enterprise | AI-gereedheidscontrole (geen certificering) |
page-artifacts | Enterprise | Pagineringselementen markeren als artefacten |
conformance-mode | Enterprise | Een conformiteitsmodus selecteren (bedoeld om te voldoen; een validator beslist) |
cjk-vertical-writing | Enterprise | Metrieken voor verticaal CJK-schrift |
opentelemetry | Core | Connect observeren met OpenTelemetry |
tagged-pdf-tutorial | 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.