<img src="media/eng.png" align="left" width="32"> This package is also available in English: Click!

Открытый пакет интеграций

OpenIntegrations — это набор инструментов для работы с внешними API, доступный в виде библиотеки (расширения) для 1С:Предприятие / OneScript и кроссплатформенного консольного приложения для Windows и Linux. Проект предоставляет готовые методы для выполнения прикладных задач (отправки сообщения, создания документа, SQL-запросов и пр.) в более чем 30 сервисах и технологиях, включая Telegram, VK, Bitrix24, Google и Yandex-сервисы, а также различные СУБД и протоколы обмена

Код проекта организован в виде набора независимых модулей, каждый из которых отвечает за работу с конкретным сервисом. При этом общая логика, вроде работы с HTTP или JSON, вынесена в переиспользуемые компоненты. Это позволяет как быстро применять готовые функции, так и легко расширять функциональность, добавляя новые методы на базе существующих компонентов. Исходный код открыт, что дает полный контроль над реализацией и позволяет сообществу участвовать в разработке <br><br>

📋 На сегодняшний день реализованы методы для работы со следующими сервисами (список) <br>

Форматы данных:

Пример работы

Отправка картинки в чат 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 версией изложена в соответствующем разделе документации

Установка и варианты релизов

<br><br>

Релизы библиотеки выходят в шести вариантах:

• Как CLI приложение для Windows и Linux (exe, rpm, deb)
• Как XML выгрузка расширения
• Как EDT проект расширения
• Как отдельный файл расширения формата cfe
• Как отдельный файл конфигурации формата cf
• Как OneScript пакет расширения ospx

<br/><br>

При использовании версий для 1С и OneScript, вы также можете просто скопировать код общих модулей в свой проект руками. Однако, вне зависимости от выбранного способа установки, рекомендуется получать файлы со страницы загрузок, Release или stable-ветки репозитория, так как в исходных файлах основной ветки бывают промежуточные данные и функции, находящиеся в процессе разработки.

Варианты для быстрого начала работы:

• Для начала работы в 1С достаточно скачать CFE файл (или XML выгрузку) расширения и загрузить его в список расширений своей конфигурации. Режим совместимости - 8.3.10 (основной) / 8.3.15 (расширения) <br>

• Для начала работы в OneScript необходимо установить пакет

  Из хаба пакетов:

      opm install oint
  

  Или из скачанного ospx файла:

      opm install -f "./OInt-x.x.x.ospx"
  

• Для начала работы с CLI (приложением для командной строки) необходимо скачать Windows-установщик или один из вариантов пакета для Linux, в зависимости от используемой операционной системы

  Также CLI версия доступна как пакет oint-cli, устанавливаемый из OPM

      opm install oint-cli
  

  При любом варианте установки, OInt CLI запускается командой oint из командной строки (при установке из Installer для Windows может потребоваться перезагрузка)

Документация

У ОПИ есть подробная документация с примерами по адресу openintegrations.dev. Там вы можете найти как общие положения о начале работы с каждым конкретным API, так и описания каждого метода с примерами кода, параметров и возвращаемых значений.

CLI версия ОПИ имеет собственную встроенную справку по всем методам. Показ справки осуществляется при вызове библиотеки без метода, метода без опций или при указании опции --help

Спонсоры ?

Представленные ниже компании поддерживают разработку Открытого пакета интеграций и вносят существенный вклад в его развитие

<img width="100" height="120" alt="Logo_GREEN-API_значок G_зеленый" src="docs/docusaurus/static/img/Sponsors/GreenAPI.png" />
GreenAPI <br/> Стабильный шлюз <br/> WhatsApp API <br/> <br/> green-api.com 🌍

Поддержать проект

Если вам нравится этот или другие мои проекты, то вы можете поддержать меня на Boosty (регулярно или единоразово). При подписке от 500 рублей открывается доступ в приватный Telegram-чат, где можно задать интересующие вопросы о проекте и получить помощь от меня напрямую. Также присутствует спонсорская подписка для компаний с приоритетной поддержкой и размещением логотипа в списке спонсоров

Спасибо за вашу поддержку!

---

Статьи на Инфостарте:<br>

• Открытый пакет интеграций для популярных API: Telegram, VK, Viber, Twitter<br>
• Библиотека для работы с Notion API (Open-source)<br>
• Библиотека работы с Яндекс Диском: делаем простейший менеджер облака за 15 минут (Open-source)<br>
• Открываем свою лавку на платформе VK Market<br>
• Библиотека для работы с Google Calendar API (open-source)<br>
• Telegram в режиме форума: делаем чаты комфортными<br>
• Открытый пакет интеграция для OneScript<br>
• Библиотека для работы с Google Drive API (open-source)<br>
• OInt CLI - приложение Открытого пакета интеграций для командной строки<br>
• Библиотека для работы со Slack (open-source)<br>
• Библиотека для работы с Google Sheets (open-source)<br>
• Библиотека для работы с Airtable (open-source)<br>
• Библиотека для работы с Dropbox (open-source)<br>
• Мастерская ОПИ: большой мануал по работе с Telegram<br>
• Библиотека для работы с Bitrix24: живая лента, задачи, файлы и личные сообщения<br>
• Работа с онлайн сервисами из консоли через OInt CLI<br>
• Библиотека для работы с VKTeams (open-source)<br>
• Управление товарами и остатками Ozon (open-source)<br>
• Библиотека для работы со CDEK (open-source)<br>
• Библиотека для работы с S3: AWS, MinIO и прочим (open-source)<br>
• TCP-клиент в 1С (open-source)<br>
• Коннектор SQLite для 1С (open-source)<br>
• Мастерская ОПИ: мануал по работе с S3 в 1С<br>
• Коннектор PostgreSQL для 1С и OneScript (open-source)<br>
• Библиотека для работы с WhatsApp через GreenAPI (open-source)<br>

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

Этот проект предоставляет библиотеку для интеграции 1С:Предприятие, OneScript и CLI с внешними сервисами через REST API и другие протоколы. Благодаря представленным в ней методам вы можете работать в экосистеме 1С:Предприятие с такими сервисами и технологиями как: 7z, Airtable, Bitrix24, CDEK, ClickHouse, Dropbox, FTP(S), Google Calendar, Google Drive, Google Sheets, GreenAPI (WhatsApp), GreenAPI (Max), gRPC, Janx, Lua, MessagePack, MongoDB, MS SQL, MySQL, Neocities, Notion, Ollama, OpenAI, PostgreSQL, RAR, RCON, ReportPortal, RSS/Atom, AWS S3, SFTP, Slack, SQLite, SSH, Tar, TCP, Telegram, Viber, VK, VK Teams, WebSocket, Yandex.Disk, ZeroMQ, HTTP

Существуют варианты поставки в виде расширения (.cfe, XML, EDT), OPM-пакета и других пакетов для разных операционных систем. Версия 1С: 8.3.10. Подходит для любых конфигураций, не использует БСП