Если вы не слышали ранее об Открытом Пакете Интеграций (что вполне вероятно), то небольшая вводная часть ниже, под катом. Для тех, кто уже знаком с ОПИ, данный раздел можно пропустить.
Открытый Пакет Интеграций (ОПИ) - это open-source набор методов для простой и быстрой интеграции с различными популярными API. Он состоит из аналогичных по функционалу 1С-расширения, OS-пакета и программы для Windows и Linux, которые предоставляют готовые методы для работы с целым набором различных онлайн-сервисов.
- ОПИ бесплатен и имеет открытый исходный код на GitHub. Вы всегда можете получить последнюю версию библиотеки на странице репозитория, а подписавшись - узнавать о выходе обновлений. Все релизы сопровождаются статьями на Инфостарт и разделами единой документации. На Инфостарт вы можете подписаться уже хоть сейчас, а про документацию я расскажу далее.
- Удобная единая документация. Она расположена на сайте opi.neocities.org и содержит в себе всю информацию, необходимую для работы: инструкции по предварительным действиям для начала интеграции, описания всех методов с параметрами и возвращаемыми значениями, примеры кода и т.д. Каждый API имеет там свой раздел.
- Простая установка. ОПИ распространяется во множестве вариантах: как XML файлы расширения, как EDT проект расширения, как файл расширения формата .cfe (версия 1С 8.3.9), как файл пакета для OneScript и еще в целом наборе пакетов и файлов для Windows и Linux. Из этого набора вы всегда сможете выбрать тот способ установки, который лучше подойдет для вашей конкретной задачи
На момент последнего обновления данной статьи, доступны следующие API:
Наиболее актуальную информацию можно посмотреть в репозитории или на вводной странице документации.
Новая библиотека - Dropbox API
Dropbox - файловый хостинг и облачное хранилище - одно из самых популярных в мире. До этого обновления в составе ОПИ уже были "облака": это Google Drive и Яндекс.Диск, и Dropbox ничем особенно от них не отличается. Выделить можно разве что версионирование файлов и более гибкую работу с общим доступом. Однако, если вы уже используете Dropbox и ищите способ взаимодействия с ним из 1С, то данный релиз придется как нельзя кстати
На данный момент в библиотеке реализованы следующие методы для работы с API Dropbox:
- Авторизация и работа с данными аккаунта
- Получение ссылки авторизации
- Получение токена
- Обновление токена
- Получение основной информации об аккаунте
- Получение информации об использованном пространстве на диске
- Работа с файлами и каталогами
- Получение информации об объекте
- Получение списка файлов в каталоге
- Получение превью для документов
- Загрузка локальных файлов на Dropbox
- Загрузка файлов на Dropbox по URL
- Получение статуса асинхронной загрузки по URL
- Удаление объекта
- Копирование объекта
- Перемещение объекта
- Создание каталога
- Скачивание каталога (как zip-архив)
- Получение списка версий объекта
- Восстановление объекта к версии
- Работа с тегами
- Получение списка тегов файла
- Добавление тега
- Удаление тега
- Настройки общего доступа
- Публикация папки в общий доступ
- Отмена публикации папки в общий доступ
- Добавление пользователей к папке в общем доступе
- Добавление пользователей к файлу
- Закрытие доступа к файлу для ранее добавленных пользователей
Подробную информацию о том, как начать работать через Открытый пакет интеграций с Dropbox или другими доступными API, вы можете найти в документации по адресу openintegrations.dev. Но на этом новости по данному обновлению еще не заканчиваются
Английская локализация
Довольно странная тема для русскоязычного ресурса, не рассказать про которую, тем не менее, было бы странно: у Открытого пакета интеграций теперь есть версия на английском языке
Это касается всех вариантов распространения: их на данный момент 8 в 3-х категориях: для 1С, для OneScript и как приложение для командной строки.
Для того, чтобы не запутаться с выбором нужного варианта в большом количестве файлов релиза, число которых, соответственно, увеличилось вдвое, в его описании теперь есть вот такая таблица
Также была сделана английская версия документации...
...и Readme-файла репозитория
Русская версия от этого не пострадала: основной Readme репозитория и русскоязычная документация на основном адресе остались прежними
Переработка интерфейса в OInt CLI
OInt CLI это, на всякий случай, приложение для Windows и Linux, которое позволяет использовать все методы Открытого пакета интеграций из командной строки/терминала (ну и из bat/sh скриптов, соответственно)
К этому обновлению была переработана цветовая схема, исправлены некоторые баги оформления, а также добавлено визуальное деление методов по разделам в рамках одной библиотеки
Вот такое вот обновление! Следите за новыми релизами в репозитории на Github, а также обязательно пишите в Issues, если столкнулись с проблемами или хотите предложить новый функционал для Открытого пакета интеграций
Спасибо за внимание!
Репозиторий ОПИ: github.com/Bayselonarrend/OpenIntegrations
Последний релиз: github.com/Bayselonarrend/OpenIntegrations/releases/latest
Другие статьи про Открытый пакет интеграций на Инфостарт:
Открытый пакет интеграций для популярных API: Telegram, VK, Viber, Twitter
Открытый пакет интеграций для OneScript
Мой GitHub: https://gitub.com/Bayselonarrend Лицензия MIT: https://mit-license.org
