Recettes Connect
NextPDF Connect ouvre le moteur NextPDF aux appelants distants et aux systèmes d’IA via le Model Context Protocol, une API REST et un service gRPC. Le livre de recettes Connect rassemble les recettes de tâches propres à cette surface, et cette page en constitue l’index. Il recense le slug réservé à chaque recette, ainsi que le niveau et la frontière de transport selon lesquels chaque recette doit être lue. Comme il s’agit d’un index, il ne formule aucune affirmation comportementale propre à une recette. Chaque page de recette est rédigée dans le dépôt nextpdf/server sous docs/public/, porte ses propres affirmations et est intégrée à ce site par l’agrégateur en conservant intacte sa provenance source.
Pour connaître le contrat suivi par chaque recette Connect, lis Conventions des recettes. Pour une vue d’ensemble des intégrations à l’échelle de l’écosystème, lis le Livre de recettes d’intégration.
Comment le niveau détermine ce que tu peux exécuter
Section intitulée « Comment le niveau détermine ce que tu peux exécuter »L’ensemble d’outils d’un déploiement Connect est calculé au démarrage, il n’est pas fixé à l’avance. Le registre d’outils du serveur enregistre les outils du cœur sans condition. Il sonde ensuite les fournisseurs Pro et Enterprise avec class_exists() et n’enregistre leurs outils que lorsque nextpdf/premium est installé aux côtés du serveur. Ainsi, une recette qui dépend d’un outil Pro ou Enterprise ne s’exécute que sur un déploiement où cet outil a été résolu. Sur une installation open source uniquement, l’outil est absent, et l’appel renvoie une erreur d’outil inconnu plutôt que de se dégrader silencieusement. Chaque recette indique son niveau, et cet index regroupe les recettes par niveau pour que tu voies d’un coup d’œil ce qu’un déploiement donné prend en charge.
Le nombre total d’outils est une propriété d’exécution du déploiement. Aucune recette ni aucune ligne de cet index ne fixe ce nombre. Le catalogue qui fait foi est le catalogue d’outils propre au serveur, vers lequel chaque recette renvoie.
Transport et modèle d’erreur
Section intitulée « Transport et modèle d’erreur »Tu invoques chaque recette de la même façon sur les trois transports — un tools/call MCP, le point d’accès REST de l’outil ou le service gRPC — parce qu’ils partagent le même exécuteur d’outils. Les recettes qui atteignent un service distant via HTTP traitent une défaillance de transport et un statut HTTP de non-succès comme deux cas distincts. Un client PSR-18 lève une exception client typée uniquement lorsqu’il ne peut pas du tout envoyer la requête — PSR-18 §4. Une réponse 4xx ou 5xx, en revanche, est une valeur de retour normale que l’appelant inspecte, et non une exception — PSR-18 §4.
La carte des slugs de recettes
Section intitulée « La carte des slugs de recettes »Chaque recette se trouve à /cookbook/connect/<recipe>/. Le tableau consigne le slug, le niveau selon lequel la recette est lue et une portée en une ligne. Les pages de recettes sont rédigées dans l’arborescence docs/public/ du dépôt nextpdf/server et sont publiées sur ce site par l’agrégateur.
| Recette | Niveau | Portée |
|---|---|---|
hello-world | Cœur | Premier appel Connect : créer, ajouter du contenu, produire la sortie |
multi-page | Cœur | Document multipage via Connect |
image-embedding | Cœur | Intégrer une image via Connect |
html-table | Cœur | Rendre un tableau HTML via Connect |
font-typography | Cœur | Polices et typographie via Connect |
exception-aware | Cœur | Appels d’outils conscients des exceptions |
environment-diagnostics | Cœur | Outils de diagnostic d’environnement |
layout-inspection | Cœur | Inspecter la mise en page sans rendu |
worker-safe | Cœur | Utilisation par lots sûre pour les workers |
batch-pdf-generation-with-progress-tracking | Cœur | Générer des PDF par lots avec suivi asynchrone de la progression |
rest-invoice-end-to-end | Cœur | Une facture via REST : soumettre, interroger, télécharger, vérifier en local |
output-approval | Cœur | Verrou de sortie avec intervention humaine |
mcp-agent-session | Cœur | Une session d’agent MCP capturée avec son aller-retour d’approbation |
event-hooks | Cœur | Hooks d’événements de cycle de vie |
fill-pdf-form | Pro | Remplir un formulaire PDF via Connect |
extract-text-content | Pro | Extraire le contenu textuel via Connect |
digital-signature | Pro | Signer un PDF (PAdES B-B et B-T) via Connect |
accessibility-check | Pro | Contrôle d’accessibilité PDF/UA |
pii-redaction | Enterprise | Supprimer les données personnelles détectées de la couche de texte (destructif) |
aria-tagged-pdf | Pro | Mapper les rôles de point de repère ARIA vers la structure balisée |
figure-caption | Pro | Figure accessible avec une légende imbriquée |
aria-noteref-pattern | Pro | Schéma d’appel de note et de corps de note |
compliance-check | Enterprise | Exécuter un contrôle par standard nommé |
forensic-analysis | Enterprise | Analyse forensique d’un PDF signé |
ltv-health-check | Enterprise | Contrôle de santé LTV (B-LT/B-LTA, Enterprise uniquement) |
batch-compliance | Enterprise | Contrôle par lots de standards |
ai-ready-certification | Enterprise | Contrôle de préparation à l’IA (pas une certification) |
page-artifacts | Enterprise | Marquer les éléments de pagination comme artefacts |
conformance-mode | Enterprise | Sélectionner un mode de conformité (destiné à se conformer ; un validateur décide) |
cjk-vertical-writing | Enterprise | Métriques d’écriture verticale CJK |
opentelemetry | Cœur | Observer Connect avec OpenTelemetry |
tagged-pdf-tutorial | Cœur | Tutoriel PDF balisé (destiné à se conformer ; veraPDF décide) |
Le slug exprime l’intention de la recette en kebab-case avec une seule barre oblique finale : pas de préfixe numérique, pas de numéro de version, pas d’extension de fichier. Un slug de recette ne change pas une fois publié, et un slug déplacé porte une redirection.
Frontière de conformité et de certification
Section intitulée « Frontière de conformité et de certification »Plusieurs recettes touchent à des standards (PDF/UA-2, PDF/A-4, PAdES). Dans le livre de recettes Connect, la prise en charge d’un standard est présentée comme une capacité, jamais comme une conformité ou une certification. Le moteur produit une sortie destinée à se conformer, et un validateur indépendant (par exemple veraPDF) détermine la conformité. La recette de préparation à l’IA est un contrôle de préparation, pas une certification. Le matériel de validation à long terme de la recette LTV est une capacité réservée à Enterprise. Sa présence dans un document correspond à une capacité portée par ce document, et non à une garantie de validité indéfinie de la signature. Chaque recette concernée réénonce intégralement ces frontières. Cet index note seulement qu’elles existent et indique d’où elles sont dérivées, plutôt que de les redériver ici.
Voir aussi
Section intitulée « Voir aussi »- Conventions des recettes — le contrat suivi par chaque recette Connect.
- Livre de recettes d’intégration — la référence des paquets et intégrations à l’échelle de l’écosystème, dont Connect est le service réseau.