Сборник рецептов Connect
NextPDF Connect делает движок NextPDF доступным для удалённых вызовов и систем искусственного интеллекта (AI) по протоколу Model Context Protocol (MCP), через REST API (Representational State Transfer) и службу gRPC. Кулинарная книга Connect собирает рецепты задач для этого интерфейса, а эта страница служит её указателем. Она фиксирует слаг каждого рецепта, уровень, к которому он относится, и применяемую транспортную границу. Поскольку это указатель, он не содержит утверждений о поведении какого-либо рецепта. Каждая страница рецепта создаётся в репозитории nextpdf/server в каталоге docs/public/, содержит собственные утверждения и подключается к этому сайту агрегатором с сохранением исходного происхождения.
Чтобы увидеть контракт, которому следует каждый рецепт Connect, прочитайте Соглашения о рецептах. Полный обзор интеграций экосистемы приведён в Кулинарной книге интеграций.
Как уровень влияет на доступные запуски
Заголовок раздела «Как уровень влияет на доступные запуски»Развёртывание Connect формирует свой набор инструментов при загрузке; он не фиксируется заранее. Реестр инструментов сервера всегда регистрирует базовые инструменты. Затем он проверяет наличие провайдеров Pro и Enterprise с помощью class_exists() и регистрирует их инструменты только если nextpdf/premium установлен рядом с сервером. Рецепт, который зависит от инструмента Pro или Enterprise, выполняется только на развёртывании, где этот инструмент удалось разрешить. При установке только из открытого исходного кода такой инструмент отсутствует, и вызов возвращает ошибку неизвестного инструмента, а не молча снижает функциональность. Каждый рецепт указывает свой уровень, а этот указатель группирует рецепты по уровням, чтобы вы могли с первого взгляда увидеть, что поддерживает развёртывание.
Общее число инструментов — это свойство развёртывания, определяемое во время выполнения. Ни один рецепт и ни одна строка в этом указателе не утверждают фиксированного числа. Источником истины служит собственный каталог инструментов сервера, на который ссылается каждый рецепт.
Транспорт и модель ошибок
Заголовок раздела «Транспорт и модель ошибок»Каждый рецепт вызывается одинаково через все три транспорта: через MCP tools/call, через конечную точку инструмента REST или через службу gRPC. Они используют один общий исполнитель инструментов. Рецепты, которые обращаются к удалённой службе по протоколу передачи гипертекста (HTTP), рассматривают сбой транспорта и неуспешный статус HTTP как разные случаи. Клиент PSR-18 выбрасывает типизированное клиентское исключение только тогда, когда он вообще не может отправить запрос, как описано в PSR-18 §4. Ответ 4xx или 5xx — это другое. Это обычное возвращаемое значение, которое проверяет вызывающая сторона, а не исключение, как описано в PSR-18 §4.
Карта слагов рецептов
Заголовок раздела «Карта слагов рецептов»Каждый рецепт находится по адресу /cookbook/connect/<recipe>/. В таблице указаны слаг, уровень, к которому относится рецепт, и однострочное описание области применения. Страницы рецептов создаются в каталоге docs/public/ репозитория nextpdf/server и публикуются на этом сайте через агрегатор.
| Рецепт | Уровень | Область применения |
|---|---|---|
hello-world | Core (базовый) | Первый вызов Connect: создание, добавление содержимого, вывод |
multi-page | Core (базовый) | Многостраничный документ через Connect |
image-embedding | Core (базовый) | Встраивание изображения через Connect |
html-table | Core (базовый) | Отрисовка HTML-таблицы через Connect |
font-typography | Core (базовый) | Шрифты и типографика через Connect |
exception-aware | Core (базовый) | Вызовы инструментов с учётом исключений |
environment-diagnostics | Core (базовый) | Инструменты диагностики окружения |
layout-inspection | Core (базовый) | Проверка макета без отрисовки |
worker-safe | Core (базовый) | Пакетное использование, безопасное для воркеров |
batch-pdf-generation-with-progress-tracking | Core (базовый) | Пакетная генерация PDF с асинхронным отслеживанием прогресса |
rest-invoice-end-to-end | Core (базовый) | Один счёт через REST: отправка, опрос, загрузка, локальная проверка |
output-approval | Core (базовый) | Шлюз вывода с участием человека |
mcp-agent-session | Core (базовый) | Записанная сессия MCP-агента с циклом подтверждения |
event-hooks | Core (базовый) | Хуки событий жизненного цикла |
fill-pdf-form | Pro (профессиональный) | Заполнение PDF-формы через Connect |
extract-text-content | Pro (профессиональный) | Извлечение текстового содержимого через Connect |
digital-signature | Pro (профессиональный) | Подписание PDF (PAdES B-B и B-T) через Connect |
accessibility-check | Pro (профессиональный) | Проверка доступности PDF/UA |
pii-redaction | Enterprise (корпоративный) | Удаление обнаруженных персональных данных из текстового слоя (необратимо) |
aria-tagged-pdf | Pro (профессиональный) | Сопоставление ролей-ориентиров ARIA с тегированной структурой |
figure-caption | Pro (профессиональный) | Доступный элемент Figure с вложенным Caption |
aria-noteref-pattern | Pro (профессиональный) | Шаблон ссылки на сноску и текста сноски |
compliance-check | Enterprise (корпоративный) | Запуск проверки по именованному стандарту |
forensic-analysis | Enterprise (корпоративный) | Криминалистический анализ подписанного PDF |
ltv-health-check | Enterprise (корпоративный) | Проверка состояния LTV (B-LT/B-LTA, только Enterprise) |
batch-compliance | Enterprise (корпоративный) | Пакетная проверка стандартов |
ai-ready-certification | Enterprise (корпоративный) | Проверка готовности к AI (не сертификация) |
page-artifacts | Enterprise (корпоративный) | Пометка элементов разбиения на страницы как артефактов |
conformance-mode | Enterprise (корпоративный) | Выбор режима соответствия (намерение соответствовать; решение принимает валидатор) |
cjk-vertical-writing | Enterprise (корпоративный) | Метрики вертикального письма CJK |
opentelemetry | Core (базовый) | Наблюдаемость Connect с помощью OpenTelemetry |
tagged-pdf-tutorial | Core (базовый) | Учебник по тегированному PDF (намерение соответствовать; решение принимает veraPDF) |
Слаг выражает назначение рецепта в стиле kebab-case с единственной завершающей косой чертой: без числового префикса, без номера версии и без расширения файла. Слаг рецепта не меняется после публикации, а перенесённый слаг сопровождается переадресацией.
Граница соответствия и сертификации
Заголовок раздела «Граница соответствия и сертификации»Несколько рецептов затрагивают стандарты (PDF/UA-2, PDF/A-4, PAdES). Кулинарная книга Connect рассматривает поддержку стандарта именно как поддержку, но никогда как соответствие или сертификацию. Движок создаёт вывод, предназначенный для соответствия, а фактическое соответствие определяет независимый валидатор (например, veraPDF). Рецепт проверки готовности к AI — это проверка готовности, а не сертификация. Материал рецепта долгосрочной проверки LTV описывает возможность, доступную только в Enterprise. Его наличие в документе — это возможность, которую несёт документ, а не гарантия бессрочной действительности подписи. Каждый затронутый рецепт полностью повторяет эти границы. Этот указатель лишь отмечает, что они существуют, и указывает, откуда они следуют, вместо того чтобы выводить их повторно здесь.
Смотрите также
Заголовок раздела «Смотрите также»- Соглашения о рецептах — контракт, которому следует каждый рецепт Connect.
- Кулинарная книга интеграций — общесистемный справочник по пакетам и интеграциям экосистемы, где Connect выступает сетевой службой.