This package is also available in English: Click!
Открытый пакет интеграций
OpenIntegrations — это набор инструментов для работы с внешними API, доступный в виде библиотеки (расширения) для 1С:Предприятие / OneScript и кроссплатформенного консольного приложения для Windows и Linux. Проект предоставляет готовые методы для выполнения прикладных задач (отправки сообщения, создания документа, SQL-запросов и пр.) в более чем 30 сервисах и технологиях, включая Telegram, VK, Bitrix24, Google и Yandex-сервисы, а также различные СУБД и протоколы обмена
Код проекта организован в виде набора независимых модулей, каждый из которых отвечает за работу с конкретным сервисом. При этом общая логика, вроде работы с HTTP или JSON, вынесена в переиспользуемые компоненты. Это позволяет как быстро применять готовые функции, так и легко расширять функциональность, добавляя новые методы на базе существующих компонентов. Исходный код открыт, что дает полный контроль над реализацией и позволяет сообществу участвовать в разработке
📋 На сегодняшний день реализованы методы для работы со следующими сервисами (список)
Пример работы
Отправка картинки в чат Telegram из 1С/OneScript
Токен = "6129457865:AAFyzNYOAFbu...";
IDЧата = "461699897";
Текст = "Крутая картинка";
Картинка = "C:/picture.jpg"; // URL, путь на диске или Двоичные данные
Результат = OPI_Telegram.ОтправитьКартинку(Токен, IDЧата, Текст, Картинка);
Тоже самое, но из CLI (пример для bash)
oint telegram ОтправитьКартинку \
--token "6129457865:AAFyzNYOAFbu..." \
--chat 461699897 \
--text "Крутая картинка" \
--picture "picture.jpg"
Для сохранения ответа в консоли можно использовать стандартное перенаправление > или опцию --out <путь к файлу>. Более подробно работа с CLI версией изложена в соответствующем разделе документации
Установка и варианты релизов
Релизы библиотеки выходят в пяти вариантах:
- Как CLI приложение для Windows и Linux (exe, rpm, deb)
- Как XML выгрузка расширения
- Как EDT проект расширения
- Как отдельный файл расширения формата cfe
- Как OneScript пакет расширения ospx
При использовании версий для 1С и OneScript, вы также можете просто скопировать код общих модулей в свой проект руками. Однако, вне зависимости от выбранного способа установки, рекомендуется получать файлы из Release или stable-ветки репозитория, так как в исходных файлах основной ветки бывают промежуточные данные и функции, находящиеся в процессе разработки.
Варианты для быстрого начала работы:
-
Для начала работы в 1С достаточно скачать CFE файл (или XML выгрузку) расширения и загрузить его в список расширений своей конфигурации
-
Для начала работы в OneScript необходимо установить пакет
Из хаба пакетов:
opm install ointИли из скачанного ospx файла:
opm install -f "./OInt-x.x.x.ospx"
-
Для начала работы с CLI (приложением для командной строки) необходимо скачать из релизов Windows-установщик или один из вариантов пакета для Linux, в зависимости от используемой операционной системы
Также CLI версия доступна как пакет
oint-cli, устанавливаемый из OPMopm install oint-cliПри любом варианте установки, OInt CLI запускается командой
ointиз командной строки (при установке из Installer для Windows может потребоваться перезагрузка)
Документация
У ОПИ есть подробная документация с примерами по адресу openintegrations.dev. Там вы можете найти как общие положения о начале работы с каждым конкретным API, так и описания каждого метода с примерами кода, параметров и возвращаемых значений.
CLI версия ОПИ имеет собственную встроенную справку по всем методам. Показ справки осуществляется при вызове библиотеки без метода, метода без опций или при указании опции --help
Спонсоры ?
Представленные ниже компании поддерживают разработку Открытого пакета интеграций и вносят существенный вклад в его развитие
 |
| GreenAPI Стабильный шлюз WhatsApp API green-api.com 🌍 |
Поддержать проект
Если вам нравится этот или другие мои проекты, то вы можете поддержать меня на Boosty (регулярно или единоразово). При подписке от 500 рублей открывается доступ в приватный Telegram-чат, где можно задать интересующие вопросы о проекте и получить помощь от меня напрямую. Также присутствует спонсорская подписка для компаний с приоритетной поддержкой и размещением логотипа в списке спонсоров
Спасибо за вашу поддержку!
Статьи на Инфостарте:
- Открытый пакет интеграций для популярных API: Telegram, VK, Viber, Twitter
- Библиотека для работы с Notion API (Open-source)
- Библиотека работы с Яндекс Диском: делаем простейший менеджер облака за 15 минут (Open-source)
- Открываем свою лавку на платформе VK Market
- Библиотека для работы с Google Calendar API (open-source)
- Telegram в режиме форума: делаем чаты комфортными
- Открытый пакет интеграция для OneScript
- Библиотека для работы с Google Drive API (open-source)
- OInt CLI - приложение Открытого пакета интеграций для командной строки
- Библиотека для работы со Slack (open-source)
- Библиотека для работы с Google Sheets (open-source)
- Библиотека для работы с Airtable (open-source)
- Библиотека для работы с Dropbox (open-source)
- Мастерская ОПИ: большой мануал по работе с Telegram
- Библиотека для работы с Bitrix24: живая лента, задачи, файлы и личные сообщения
- Работа с онлайн сервисами из консоли через OInt CLI
- Библиотека для работы с VKTeams (open-source)
- Управление товарами и остатками Ozon (open-source)
- Библиотека для работы со CDEK (open-source)
- Библиотека для работы с S3: AWS, MinIO и прочим (open-source)
- TCP-клиент в 1С (open-source)
- Коннектор SQLite для 1С (open-source)
- Мастерская ОПИ: мануал по работе с S3 в 1С
- Коннектор PostgreSQL для 1С и OneScript (open-source)
- Библиотека для работы с WhatsApp через GreenAPI (open-source)
- Открытый Пакет интеграций (OpenIntegrations)
Licensed under the MIT License
Список зависимостей находится в файле NOTICE
Синопсис
Этот проект предоставляет библиотеку для интеграции 1С:Предприятие, OneScript и CLI с внешними сервисами через REST API и другие протоколы. Благодаря представленным в ней методам вы можете работать в экосистеме 1С:Предприятие с такими сервисами и технологиями как: Airtable, Bitrix24, CDEK, Dropbox, FTP, Google Calendar, Google Drive, Google Sheets, GreenAPI, GreenMax, MongoDB, MSSQL, MySQL, Neocities, Notion, Ollama, OpenAI, PostgreSQL, RCON, ReportPortal, S3, SFTP, Slack, SQLite, SSH, TCP, Telegram, Twitter, Viber, VK, VKTeams, Yandex Disk, HTTP-client, HTTP-клиент
Существуют варианты поставки в виде расширения (.cfe, XML, EDT), OPM-пакета и других пакетов для разных операционных систем. Версия 1С: 8.3.10. Подходит для любых конфигураций, не использует БСП