OpenIntegrations

Набор инструментов интеграции с популярными сервисами и технологиями для 1С:Предприятие, OneScript и CLI (Telegram, VK, Bitrix24, Google, Яндекс, S3, PostgreSQL, SQLite, MySQL и др.)

Generate Convert Improve

Install / Use

/learn @Bayselonarrend/OpenIntegrations

About this skill

Quality Score

0/100

README

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

<hr>

Main

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

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, устанавливаемый из OPM
```
    opm install oint-cli
```
При любом варианте установки, OInt CLI запускается командой oint из командной строки (при установке из Installer для Windows может потребоваться перезагрузка)

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

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

Docs

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

Спонсоры ?

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

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

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

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

Related Skills

apple-reminders

342.5k

Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

gh-issues

342.5k

Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5] [--notify-channel -1002381931352]

imsg

342.5k

iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.

oracle

342.5k

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).