LOGORIC / KNOWLEDGE

Инструкции и шаблоны

Настройка каждого раздела, проверка результата и готовые сценарии для вашего проекта.

Модули · Руководство на русском

Разработка модулей (SDK)

Создайте модуль для магазина Logoric: готовый пакет правил, встроенное приложение или интеграцию через вебхуки. Код модуля работает на вашем сервере.

Порядок настройки

  1. Опишите модуль в manifest.json (схема: /sdk/manifest.schema.json). Обязательно: id, name, version, summary, category, author, pricing и хотя бы одно из contents, app, webhooks.
  2. Для приложения подключите /sdk/logoric-module-sdk.js и вызовите LogoricModule.init(). Приложение получит временный токен с правами из манифеста (services:read, incidents:read, incidents:write, logs:read, metrics:read, uptime:read) и сможет вызывать API организации.
  3. Для вебхуков укажите HTTPS-адрес и события incident.opened / incident.resolved. Проверяйте подпись X-Logoric-Signature: sha256 HMAC от строки «timestamp.body» секретом, полученным при первой отправке.
  4. Отправьте модуль: «Магазин модулей → Разработчикам → Отправить на проверку» или командой logoric-module submit manifest.json --org <ID> с API-ключом write.
  5. Администратор Logoric проверит модуль, задаст видимость (всем или выбранным организациям) и цену. Статус и комментарий проверки видны в разделе «Разработчикам».
  6. Новая версия отправляется так же; опубликованная версия работает, пока новая на проверке.
go run ./apps/module-cli validate manifest.json

Ожидаемый результат

Модуль доступен в магазине у нужных организаций.

Если не получается

  • invalid_manifest — сообщение указывает на поле с ошибкой; неизвестные поля запрещены.
  • module_permission_denied — приложение обращается к API, на который нет права в манифесте.
  • Приложение не загружается — проверьте HTTPS и что страница разрешает встраивание (без X-Frame-Options: DENY).