API расширений

Подключённые модули и плагины могут публиковать собственные HTTP-методы. Базовый шаблон пути: /api/module/{имя_расширения}/{…}.

Схема URL

Все публичные методы расширения живут под единым префиксом ядра. Конкретные сегменты пути и методы задаёт поставщик расширения в его OpenAPI.

GET|POST|…  /api/module/{plugin_name}/{path}

Discovery

1. Установите и запустите расширение в админ-панели (раздел плагинов или маркет).
2. Откройте GET /api/openapi.json — появятся новые paths и tags.
3. Если расширение не в статусе «started», маршрут не регистрируется — клиент получит 404.

Рекомендации интегратору

• Не полагайтесь на захардкоженные пути — сверяйтесь со spec на стенде.
• Уточните у поставщика: тип auth (JWT, API-key, custom), коды ошибок, лимиты.
• Совместимость версии расширения с ядром — в документации поставщика и release notes.

Сводная таблица ядра — индекс endpoint'ов.