https://github.com/bayselonarrend/openintegrations
Набор инструментов интеграции с популярными сервисами и технологиями для 1С:Предприятие, OneScript и CLI (Telegram, VK, Bitrix24, Google, Яндекс, S3, PostgreSQL, SQLite, MySQL и др.)
https://github.com/bayselonarrend/openintegrations
1c 1c-edt 1c-enterprise 1script airtable api bsl cli cli-app google-cloud integration notion onescript postgresql slack telegram twitter viber vk yandex-disk
Last synced: 11 days ago
JSON representation
Набор инструментов интеграции с популярными сервисами и технологиями для 1С:Предприятие, OneScript и CLI (Telegram, VK, Bitrix24, Google, Яндекс, S3, PostgreSQL, SQLite, MySQL и др.)
- Host: GitHub
- URL: https://github.com/bayselonarrend/openintegrations
- Owner: Bayselonarrend
- License: mit
- Created: 2023-12-29T06:21:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-12T19:59:27.000Z (11 days ago)
- Last Synced: 2025-04-13T00:42:12.573Z (11 days ago)
- Topics: 1c, 1c-edt, 1c-enterprise, 1script, airtable, api, bsl, cli, cli-app, google-cloud, integration, notion, onescript, postgresql, slack, telegram, twitter, viber, vk, yandex-disk
- Language: 1C Enterprise
- Homepage: https://openintegrations.dev
- Size: 400 MB
- Stars: 334
- Watchers: 19
- Forks: 32
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
*This package is also available in English: [Click!](https://github.com/Bayselonarrend/OpenIntegrations/blob/main/README_ENG.md)*
# Открытый пакет интеграций
[](https://openyellow.org/grid?data=top&repo=736878759)
[](https://github.com/EvilBeaver/OneScript)
Набор инструментов интеграции с популярными API: консольное приложение (Windows/Linux) и библиотека (расширение) для 1C:Enterprise/OneScript, состоящие из общего набора готовых функций для работы с множеством известных облачных сервисов
Все реализованные методы из набора выполняют отдельные прикладные задачи, вроде `ОтправитьСообщение` или `СоздатьПост`, что позволяет использовать их без углубления в реализацию. Но код, при этом, достаточно сильно декомпозирован: методы авторизации, получения данных и пр. по возможности вынесены в отдельные функции. Это позволяет легко добавлять новые методы на основе уже существующих, не разматывая клубок реализации до самого начала работы с API.
На сегодняшний день реализован инструментарий для работы со следующими сервисами:
## Пример работы
Отправка картинки в чат Telegram из 1С/OneScript
```bsl
Токен = "6129457865:AAFyzNYOAFbu...";
IDЧата = "461699897";
Текст = "Крутая картинка";
Картинка = "C:/picture.jpg"; // URL, путь на диске или Двоичные данные
Результат = OPI_Telegram.ОтправитьКартинку(Токен, IDЧата, Текст, Картинка);
```
Тоже самое, но из CLI (пример для bash)
```bash
oint telegram ОтправитьКартинку \
--token "6129457865:AAFyzNYOAFbu..." \
--chat 461699897 \
--text "Крутая картинка" \
--picture "picture.jpg"
```
Для сохранения ответа в консоли можно использовать стандартное перенаправление `>` или опцию `--out <путь к файлу>`. Более подробно работа с CLI версией изложена в соответствующем [разделе документации](https://openintegrations.dev/docs/Start/CLI_version)
## Установка и варианты релизов ##
#### Релизы библиотеки выходят в пяти вариантах:
- Как CLI приложение для Windows и Linux (exe, rpm, deb)
- Как XML выгрузка расширения
- Как EDT проект расширения
- Как отдельный файл расширения формата cfe
- Как [OneScript](https://github.com/EvilBeaver/OneScript) пакет расширения ospx
При использовании версий для 1С и OneScript, вы также можете просто скопировать код общих модулей из релизов в свой проект руками. Однако, вне зависимости от выбранного сопособа установки, получать файлы необходимо из [Release](https://github.com/Bayselonarrend/OpenIntegrations/releases/latest), так как в самих исходных файлах репозитория бывают промежуточные данные и функции, находящиеся в процессе разработки.
+ Для начала работы в 1С достаточно скачать CFE файл (или XML выгрузку) расширения и загрузить его в список расширений своей конфигуарции
+ Для начала работы в OneScript необходимо установить пакет
Из хаба пакетов:
```powershell
opm install oint
```
Или из скачанного ospx файла:
```powershell
opm install -f "./OInt-x.x.x.ospx"
```
+ Для начала работы с CLI (приложением для командной строки) необходимо скачать из релизов Windows-установщик или один из вариантов пакета для Linux, в зависимости от используемой операционной системы
Также CLI версия доступна как пакет `oint-cli`, устанавливаемый из OPM
```powershell
opm install oint-cli
```
При любом варианте установки, OInt CLI запускается командой `oint` из командной строки (при установке из Installer для Windows может потребоватья перезагрузка)
>[!WARNING]
>Также, для CLI приложения существует поставка единым exe-файлом. Для его запуска требуется .Net Framework 4.8 или Mono соответствующей версии.
>Данный вариант поставки имеет проблемы с производительностью, поэтому рекомендуется использовать его только в том случае, если использование других вариантов на целевой системе нежелательно или невозможно
## Документация ##
У ОПИ есть подробная документация с примерами по адресу [https://openintegrations.dev](https://openintegrations.dev). Там вы можете найти как общие положения о начале работы с каждым конкретным API, так и описания каждого метода с примерами кода, параметров и возвращаемых значений.
CLI версия ОПИ имеет собственную встроенную справку по всем методам. Показ справки осуществляется при вызове библиотеки без метода, метода без опций или при указании опции `--help`
## Поддержать проект ##
Если вам нравится проект OpenIntegrations и вы хотите его поддержать, то можете сделать это одним из следующих способов:
+ Поставить ⭐ этому репозиторию
+ Поставить `+` на статьи про ОПИ [на Инфостарт](https://infostart.ru/profile/1793672/)
При желании, вы также можете помочь проекту материально через Tribute или YooMoney, нажав на один из значков ниже или по ссылкам, которые находятся в правой части страницы
**Спасибо за вашу поддержку!**
___
>
>
>Статьи на Инфостарте:
>- [Открытый пакет интеграций для популярных API: Telegram, VK, Viber, Twitter](https://infostart.ru/1c/articles/2016164/)
>- [Библиотека для работы с Notion API (Open-source)](https://infostart.ru/1c/articles/2022254/)
>- [Библиотека работы с Яндекс Диском: делаем простейший менеджер облака за 15 минут (Open-source)](https://infostart.ru/1c/articles/2038960/)
>- [Открываем свою лавку на платформе VK Market](https://infostart.ru/public/2043994/)
>- [Библиотека для работы с Google Calendar API (open-source)](https://infostart.ru/1c/articles/2049575/)
>- [Telegram в режиме форума: делаем чаты комфортными](https://infostart.ru/1c/articles/2055811/)
>- [Открытый пакет интеграция для OneScript](https://infostart.ru/1c/articles/2060307/)
>- [Библиотека для работы с Google Drive API (open-source)](https://infostart.ru/1c/articles/2066469/)
>- [OInt CLI - приложение Открытого пакета интеграций для командной строки](https://infostart.ru/1c/articles/2074205/)
>- [Библиотека для работы со Slack (open-source)](https://infostart.ru/1c/articles/2099282/)
>- [Библиотека для работы с Google Sheets (open-source)](https://infostart.ru/1c/articles/2102248/)
>- [Библиотека для работы с Airtable (open-source)](https://infostart.ru/1c/articles/2106649/)
>- [Библиотека для работы с Dropbox (open-source)](https://infostart.ru/1c/articles/2123857/)
>- [Мастерская ОПИ: большой мануал по работе с Telegram](https://infostart.ru/1c/articles/2135517/)
>- [Библиотека для работы с Bitrix24: живая лента, задачи, файлы и личные сообщения](https://infostart.ru/1c/articles/2148213/)
>- [Работа с онлайн сервисами из консоли через OInt CLI](https://infostart.ru/1c/articles/2159665/)
>- [Библиотека для работы с VKTeams (open-source)](https://infostart.ru/1c/articles/2170692/)
>- [Управление товарами и остатками Ozon (open-source)](https://infostart.ru/1c/articles/2187012/)
>- [Библиотека для работы со CDEK (open-source)](https://infostart.ru/1c/articles/2216121/)
>- [Библиотека для работы с S3: AWS, MinIO и прочим (open-source)](https://infostart.ru/1c/articles/2244019/)
>- [TCP-клиент в 1С (open-source)](https://infostart.ru/1c/articles/2272364/)
>- [Коннектор SQLite для 1С (open-source)](https://infostart.ru/1c/articles/2276707/)
>- [Мастерская ОПИ: мануал по работе с S3 в 1С](https://infostart.ru/1c/articles/2288171/)
>- [Коннектор PostgreSQL для 1С и OneScript (open-source)](https://infostart.ru/1c/articles/2314338/)
>- [Библиотека для работы с WhatsApp через GreenAPI (open-source)](https://infostart.ru/1c/articles/2327294/)
>- Открытый Пакет интеграций (OpenIntegrations)
>Licensed under the MIT License
>Список зависимостей находится в файле NOTICE