Recettes Connect
Recettes Connect
Section intitulée « 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 nextpdf/serverdocs/public/ et s’agrègent ici. Tant qu’une page n’a pas encore atterri, son lien est une référence anticipée.
| Recette | Niveau | Portée |
|---|---|---|
hello-world (prévu en amont) | Cœur | Premier appel Connect : créer, ajouter du contenu, produire la sortie |
multi-page (prévu en amont) | Cœur | Document multipage via Connect |
image-embedding (prévu en amont) | Cœur | Intégrer une image via Connect |
html-table (prévu en amont) | Cœur | Rendre un tableau HTML via Connect |
font-typography (prévu en amont) | Cœur | Polices et typographie via Connect |
exception-aware (prévu en amont) | Cœur | Appels d’outils conscients des exceptions |
environment-diagnostics (prévu en amont) | Cœur | Outils de diagnostic d’environnement |
layout-inspection (prévu en amont) | Cœur | Inspecter la mise en page sans rendu |
worker-safe (prévu en amont) | Cœur | Utilisation par lots sûre pour les workers |
output-approval (prévu en amont) | Cœur | Verrou de sortie avec intervention humaine |
event-hooks (prévu en amont) | Cœur | Hooks d’événements de cycle de vie |
fill-pdf-form (prévu en amont) | Pro | Remplir un formulaire PDF via Connect |
extract-text-content (prévu en amont) | Pro | Extraire le contenu textuel via Connect |
digital-signature (prévu en amont) | Pro | Signer un PDF (PAdES B-B et B-T) via Connect |
accessibility-check (prévu en amont) | Pro | Contrôle d’accessibilité PDF/UA |
pii-redaction (prévu en amont) | Enterprise | Supprimer les données personnelles détectées de la couche de texte (destructif) |
aria-tagged-pdf (prévu en amont) | Pro | Mapper les rôles de point de repère ARIA vers la structure balisée |
figure-caption (prévu en amont) | Pro | Figure accessible avec une légende imbriquée |
aria-noteref-pattern (prévu en amont) | Pro | Schéma d’appel de note et de corps de note |
compliance-check (prévu en amont) | Enterprise | Exécuter un contrôle par standard nommé |
forensic-analysis (prévu en amont) | Enterprise | Analyse forensique d’un PDF signé |
ltv-health-check (prévu en amont) | Enterprise | Contrôle de santé LTV (B-LT/B-LTA, Enterprise uniquement) |
batch-compliance (prévu en amont) | Enterprise | Contrôle par lots de standards |
ai-ready-certification (prévu en amont) | Enterprise | Contrôle de préparation à l’IA (pas une certification) |
page-artifacts (prévu en amont) | Enterprise | Marquer les éléments de pagination comme artefacts |
conformance-mode (prévu en amont) | Enterprise | Sélectionner un mode de conformité (destiné à se conformer ; un validateur décide) |
cjk-vertical-writing (prévu en amont) | Enterprise | Métriques d’écriture verticale CJK |
opentelemetry (prévu en amont) | Cœur | Observer Connect avec OpenTelemetry |
tagged-pdf-tutorial (prévu en amont) | 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.