1c/OpenIntegrations
1
0
Fork 0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2026-05-16 09:38:28 +02:00
Code Issues Releases Activity

Fastfix

Browse Source
This commit is contained in:
Anton Titovets
2026-05-02 23:22:14 +03:00
parent 7db7bd2078
commit 1b54d8fbea
1 changed files with 0 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files
article-opi-release-2.0.0.md
-43
View File
@@ -1,43 +0,0 @@
# ОПИ вышел в 2.0.0: WebSocket и ещё кое-что
**02.05.2026**
Вышла вторая мажорная версия Открытого пакета интеграций. Номер сменился не «для галочки»: в составе есть крупная новая подсистема, отдельные способы поставки под старые платформы, доработка HTTP и MCP в консоли. Ниже по смыслу, без простыни из строк релиз-нотов.
Если про ОПИ вы читаете впервые: это открытый набор методов для интеграций — расширение для 1С, пакет под OneScript, CLI под Windows и Linux. Код на GitHub, описания методов и примеры — на [openintegrations.dev](https://openintegrations.dev).
## Зачем эта версия отдельным текстом
Большую часть жизни пакета по-прежнему кормят обычные HTTP-сервисы: запрос, ответ, иногда файл или редирект. Но в реальных проектах регулярно всплывают три других запроса. Первый — долгое двустороннее соединение без опроса «каждые пять секунд». Второй — возможность перед вызовом метода без цирка подкрутить таймаут, прокси или формат ответа, не раздувая сигнатуру функций. Третий — возможность принести код на базу там, где удобен не CFE, а именно файл конфигурации CF под конкретную линию платформы.
В 2.0.0 есть ответ на все три пункта, плюс в CLI добавлен MCP — для тех, кто хочет вызывать возможности консоли не только из командной строки.
## WebSocket
WebSocket нужен там, где «один запрос — один ответ» начинает мешать: уведомления, чаты, стрим данных, свой сервер для входящих соединений. После установки соединения стороны обмениваются сообщениями в обе стороны без каждого раза заново разворачивать HTTP-сессию.
В ОПИ это оформлено модулем `OPI_WebSocket`. С клиента: подключиться (при желании через TLS или прокси), слать текст и двоичные данные, принимать ответы, пинг-понг, закрыть сессию нормальным кодом. С сервера: слушать порт, разбирать входящие сессии по id, отдавать данные в конкретное соединение, закрывать их и смотреть список активных. Для отладки можно включить лог — на память или в файл, как уже делают другие части пакета.
Реализация на внешней компоненте, в том же духе, что и остальной «нетривиальный» транспорт в ОПИ. Подробности по параметрам — в документации раздела WebSocket.
## Расширенный вызов
Раньше, если нужен был не «голый JSON из тела», а ещё код ответа с заголовками, или другой таймаут на один конкретный вызов, приходилось либо городить свой HTTP поверх общих утилит, либо мириться с тем, что параметры методов заточены только под «суть» запроса: токен, chat id, текст.
Теперь для части методов можно вызывать их **через расширенный вызов**: передаются обычные аргументы, отдельно — структура настроек HTTP-клиента (таймаут, расширенный ответ, прокси и т.п. — какие ключи поддерживаются, зависит от метода). В 1С/OneScript это функции из `OPI_РасширенныйВызов`; в CLI — опция `--config` с JSON. В документации для методов добавлены таблицы с этими ключами — не нужно гадать по исходникам.
## Поставка в CF под 8.3.10
У ОПИ и раньше было несколько способов установки: CFE, EDT-проект, OneScript-пакеты, сборки CLI. Новое — отдельный вариант **файла конфигурации .cf**, ориентированный на платформу **8.3.10**. Если у вас как раз такой контур или политики про CF, а не про расширение отдельным файлом, появился ещё один легальный путь.
Отдельно: в релизе подняты требования к режиму совместимости расширения (и основной конфигурации там, где это важно). Перед обновлением с 1.34 имеет смысл глянуть релиз-ноты и свои настройки совместимости, чтобы потом не ловить сюрприз при открытии базы.
## MCP в CLI
Консоль ОПИ давно используют в скриптах и CI. В сборку добавили **встроенный MCP-сервер через stdio** — стандартный способ подключить набор методов к средам, где инструменты объявляют себя по протоколу MCP и вызываются не руками, а клиентом. Если вы MCP уже не используете, строка для запаса на будущее: когда понадобится, не придётся писать свою заглушку.
Как запускать и что передаётся — см. [документацию MCP в CLI](https://openintegrations.dev/docs/Start/CLI-version/mcp-server).
---
Остальной список правок из 2.0.0 лежит в репозитории и анонсе релиза: там и мелкие исправления HTTP/OS, RSS, gRPC, и снятый с поддержки модуль Twitter, и прочее. Если по WebSocket или расширенному вызову появятся вопросы — их проще всего решить через issues на GitHub или обсуждение рядом с статьёй на Инфостарт.