Recetario de Connect
NextPDF Connect expone el motor de NextPDF a clientes remotos y sistemas de IA mediante el Model Context Protocol, una API REST y un servicio gRPC. El recetario de Connect reúne recetas orientadas a tareas para esa superficie, y esta página es su índice. Registra el slug asignado a cada receta, junto con el nivel y el límite de transporte desde los que debe leerse. Al ser un índice, no afirma nada sobre el comportamiento de ninguna receta. Cada página de receta se redacta en el repositorio nextpdf/server, dentro de docs/public/, es responsable de sus propias afirmaciones y se incorpora a este sitio mediante el agregador con su procedencia original intacta.
Para ver el contrato que sigue cada receta de Connect, leer Convenciones de las recetas. Para obtener una visión de las integraciones de todo el ecosistema, leer el Recetario de integraciones.
Cómo afecta el nivel a lo que se puede ejecutar
Sección titulada «Cómo afecta el nivel a lo que se puede ejecutar»El conjunto de herramientas de un despliegue de Connect se determina al arrancar; no se fija de antemano. El registro de herramientas del servidor registra las herramientas del núcleo de forma incondicional. Después comprueba los proveedores Pro y Enterprise con class_exists(), y registra sus herramientas solo cuando nextpdf/premium está instalado junto al servidor. Así, una receta que depende de una herramienta Pro o Enterprise solo se ejecuta en un despliegue donde esa herramienta se haya resuelto. En una instalación únicamente de código abierto, la herramienta está ausente y la llamada devuelve un error de herramienta desconocida en lugar de degradarse silenciosamente. Cada receta indica su nivel, y este índice agrupa las recetas por nivel para saber de un vistazo qué admite un despliegue determinado.
El número total de herramientas es una propiedad de tiempo de ejecución del despliegue. Ninguna receta ni ninguna fila de este índice afirma un número fijo. La referencia canónica es el propio catálogo de herramientas del servidor, al que enlaza cada receta.
Transporte y modelo de errores
Sección titulada «Transporte y modelo de errores»Invocar cada receta de la misma manera a través de los tres transportes —un tools/call de MCP, el endpoint REST de herramientas o el servicio gRPC— porque comparten un mismo ejecutor de herramientas. Las recetas que acceden a un servicio remoto por HTTP tratan un fallo de transporte y un estado HTTP no satisfactorio como dos casos distintos. Un cliente PSR-18 lanza una excepción de cliente tipada solo cuando no puede enviar la petición en absoluto — PSR-18 §4. En cambio, una respuesta 4xx o 5xx es un valor de retorno normal que el invocador inspecciona, no una excepción — PSR-18 §4.
El mapa de slugs de las recetas
Sección titulada «El mapa de slugs de las recetas»Cada receta reside en /cookbook/connect/<recipe>/. La tabla registra el slug, el nivel desde el que debe leerse la receta y un alcance de una línea. Las páginas de las recetas se redactan en el árbol docs/public/ del repositorio nextpdf/server y se publican en este sitio a través del agregador.
| Receta | Nivel | Alcance |
|---|---|---|
hello-world | Core | Primera llamada a Connect: crear, añadir contenido, generar la salida |
multi-page | Core | Documento de varias páginas mediante Connect |
image-embedding | Core | Insertar una imagen mediante Connect |
html-table | Core | Representar una tabla HTML mediante Connect |
font-typography | Core | Fuentes y tipografía mediante Connect |
exception-aware | Core | Llamadas a herramientas con gestión de excepciones |
environment-diagnostics | Core | Herramientas de diagnóstico del entorno |
layout-inspection | Core | Inspeccionar el diseño sin representar |
worker-safe | Core | Uso por lotes seguro para workers |
batch-pdf-generation-with-progress-tracking | Core | Generar PDF por lotes con seguimiento de progreso asíncrono |
rest-invoice-end-to-end | Core | Una factura por REST: enviar, sondear, descargar y verificar en local |
output-approval | Core | Compuerta de salida con intervención humana |
mcp-agent-session | Core | Una sesión de agente MCP capturada con el ciclo de aprobación |
event-hooks | Core | Hooks de eventos del ciclo de vida |
fill-pdf-form | Pro | Rellenar un formulario PDF mediante Connect |
extract-text-content | Pro | Extraer contenido de texto mediante Connect |
digital-signature | Pro | Firmar un PDF (PAdES B-B y B-T) mediante Connect |
accessibility-check | Pro | Comprobación de accesibilidad PDF/UA |
pii-redaction | Enterprise | Eliminar de la capa de texto los datos personales detectados (destructivo) |
aria-tagged-pdf | Pro | Asignar roles de referencia ARIA a la estructura etiquetada |
figure-caption | Pro | Figure accesible con Caption anidado |
aria-noteref-pattern | Pro | Patrón de referencia y cuerpo de nota al pie |
compliance-check | Enterprise | Ejecutar una comprobación de un estándar con nombre |
forensic-analysis | Enterprise | Análisis forense de un PDF firmado |
ltv-health-check | Enterprise | Comprobación de salud LTV (B-LT/B-LTA, solo Enterprise) |
batch-compliance | Enterprise | Comprobación de estándares por lotes |
ai-ready-certification | Enterprise | Comprobación de preparación para IA (no es una certificación) |
page-artifacts | Enterprise | Marcar los elementos de paginación como artefactos |
conformance-mode | Enterprise | Seleccionar un modo de conformidad (con la intención de cumplir; lo decide un validador) |
cjk-vertical-writing | Enterprise | Métricas de escritura vertical CJK |
opentelemetry | Core | Observar Connect con OpenTelemetry |
tagged-pdf-tutorial | Core | Tutorial de PDF etiquetado (con la intención de cumplir; lo decide veraPDF) |
El slug representa la intención de la receta en kebab-case con una sola barra al final: sin prefijo numérico, sin número de versión, sin extensión de archivo. Una vez publicado, un slug de receta no cambia; si se mueve, lleva una redirección.
Límite de conformidad y certificación
Sección titulada «Límite de conformidad y certificación»Varias recetas abordan estándares (PDF/UA-2, PDF/A-4, PAdES). El recetario de Connect interpreta la compatibilidad con un estándar como compatibilidad, nunca como conformidad ni certificación. El motor produce una salida con la intención de cumplir, y un validador independiente (por ejemplo, veraPDF) determina la conformidad. La receta de preparación para IA es una comprobación de preparación, no una certificación. El material de validación a largo plazo de la receta de LTV es una capacidad exclusiva de Enterprise. Que esté presente en un documento significa que el documento incorpora esa capacidad, no que la firma tenga una validez indefinida garantizada. Cada receta afectada vuelve a exponer estos límites en su totalidad. Este índice solo deja constancia de que existen y señala de dónde se derivan, en lugar de volver a derivarlos aquí.
Véase también
Sección titulada «Véase también»- Convenciones de las recetas — el contrato que sigue cada receta de Connect.
- Recetario de integraciones — la referencia de paquetes e integraciones de todo el ecosistema, del que Connect es el servicio de red.