На хайпе: интегрируем 1С с сервисом видеоконференций Zoom
По причине коронавируса всем резко понадобились видеоконференции, а Зум (zoom.us) — одна из самых популярных платформ для этого. Когда пользователей и трансляций в зуме много, возникает необходимость в автоматизации. Рассматривается интеграция 1С с Zoom через API — от регистрации в сервисе до создания конференции из 1С.
- Описание
- Подробнее
Описание
У платформы много возможностей, и всем можно управлять через личный кабинет — но при большом количестве трансляций нажимать на кнопочки руками становится утомительно.
Тут на помощь и приходит API — и на те же кнопочки можно нажимать программно.
Приложенная обработка — это не всеобъемлющее решение, реализовано всего пара методов для примера. Зато это позволит с чего-то начать и, возможно, сэкономить несколько дней разработки.
Начнем с регистрации в сервисе, тут ничего нового.
Затем открываем документацию по АПИ — она будет нашей настольной книгой на время разработки.
Из документации узнаем, что для межсерверного взаимодействия нам рекомендуют использовать авторизацию с помощью JSON Web Token (JWT).
Заходим в раздел разработчика, нажимаем Develop — Build App, выбираем JWT и жмем Create. Вуаля! Разработка на стороне Зума закончена!
Из раздела App Credentials копируем API Key и API Secret, они нам понадобятся в дальнейшем.
Теперь переходим в 1С.
Для “общения” с API нам потребуется адрес апи — https://api.zoom.us/v2/, API Key и API Secret.
Естественно, API Key и API Secret передаются в Зум не в открытом виде, на их основе генерируется JSON Web Token (JWT). Функцию по генерации токена мы реализуем в 1С.
Сгенерированный токен затем вставляется в заголовок запроса с ключом “authorization” и значением “Bearer “ + JWT. В Postman это выглядит так:
Теперь можно переходить к реализации методов. Я для примера взял один GET метод — получение списка пользователей и один POST — создание конференции.
Для получения списка пользователей никаких дополнительных сведений не надо — нажимаем на кнопку, и если у нас все правильно настроено, получаем список.
Для создания конференции надо выбрать пользователя, от имени которого будет создана конференция. Для этого кликаем два раза на пользователя в табличке, видим, что заполняется строка ID Пользователя под таблицей.
По желанию меняем дополнительные параметры — время начала, продолжительность, текст. На самом деле параметров и настроек гораздо больше, они перечислены в документации.
Нажимаем на кнопку создать конференцию, и, в случае успешного создания, заполняются поля со ссылками.
Ссылка на старт — это ссылка для организатора конференции, так называемого “хоста”, он имеет право управлять трансляцией.
Ссылка на присоединение — это ссылка для зрителей.
Тестировалось на версии 1С:Предприятие 8.3 (8.3.15.1830)