*This package is also available in English: [Click!](https://github.com/Bayselonarrend/OpenIntegrations/blob/main/README_ENG.md)*
![Main](https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/main.gif#gh-dark-mode-only#gh-dark-mode-only) ![Main-light](https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/main-light.gif#gh-light-mode-only) # Открытый пакет интеграций ![Версия](https://img.shields.io/badge/Версия_1С-8.3.9-yellow) [![OpenYellow](https://img.shields.io/endpoint?url=https://openyellow.org/data/badges/2/736878759.json)](https://openyellow.org/grid?data=top&repo=736878759)
Набор инструментов интеграции с популярными 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)
## Установка и варианты релизов ## [![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/bayselonarrend/OpenIntegrations/total?logo=github)](https://github.com/Bayselonarrend/OpenIntegrations/releases/latest)

#### Релизы библиотеки выходят в пяти вариантах: - Как 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, в зависимости от используемой операционной системы. Дополнительно требуется наличие установленного **.Net Framework 4.8** или **Mono соответствующей версии** (системные требования OneScript). При установке из `rpm` или `deb` пакетов устанавливается автоматически Также CLI версия доступна как пакет `oint-cli`, устанавливаемый из OPM ```powershell opm install oint-cli ``` При любом варианте установки, OInt CLI запускается командой `oint` из командной строки (при установке из Installer для Windows может потребоватья перезагрузка)
>[!WARNING] >Не рекомендуется напрямую использовать методы служебных модулей (OPI_Инструменты, OPI_Криптография) в вашем проекте (если вы собираетесь обновляться до новых версий в дальнейшем). Для сохранения обратной совместимости, количество/назначение параметров и типы возвращаемых значений для методов работы с API не изменяются, но это не применимо к служебным модулям, которые могут изменяться как угодно для оптимизации и дополнения под новые нужды. Если вам необходим функционал из служебных модулей, рекомендуется скопировать его себе отдельно.
## Документация ## У ОПИ есть подробная документация с примерами по адресу [https://openintegrations.dev](https://openintegrations.dev). Там вы можете найти как общие положения о начале работы с каждым конкретным API, так и описания каждого метода с примерами кода, параметров и возвращаемых значений. ![Docs](https://github.com/Bayselonarrend/OpenIntegrations/raw/main/Media/docs.png?4) CLI версия ОПИ имеет собственную встроенную справку по всем методам. Показ справки осуществляется при вызове библиотеки без метода, метода без опций или при указании опции `--help` ___
>![Infostart](https://github.com/Bayselonarrend/TelegramEnterprise/raw/main/infostart.svg) > >Статьи на Инфостарте:
>- [Открытый пакет интеграций для популярных 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/)

>- Открытый Пакет интеграций (OpenIntegrations)
>Licensed under the MIT License
>Список зависимостей находится в файле NOTICE