This package is also available in English: Click!

---

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

Набор инструментов интеграции с популярными API: консольное приложение (Windows/Linux) и библиотека (расширение) для 1C:Enterprise/OneScript, состоящие из общего набора готовых функций для работы с множеством известных облачных сервисов

Все реализованные методы из набора выполняют отдельные прикладные задачи, вроде ОтправитьСообщение или СоздатьПост, что позволяет использовать их без углубления в реализацию. Но код, при этом, достаточно сильно декомпозирован: методы авторизации, получения данных и пр. по возможности вынесены в отдельные функции. Это позволяет легко добавлять новые методы на основе уже существующих, не разматывая клубок реализации до самого начала работы с API.

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

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

Отправка картинки в чат 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, так и описания каждого метода с примерами кода, параметров и возвращаемых значений.

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, Green API, MSSQL, MySQL, Neocities, Notion, Ozon, PostgreSQL, RCON, ReportPortal, S3, SFTP, Slack, SQLite, SSH, TCP, Telegram, Twitter, Viber, VK, VKTeams, Yandex Disk

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