Документация
Интеграции
Доступ к сервисам
Процессы в ходе выполнения могут делать веб-запросы к внешним системам, сайтам и сервисам. Некоторые сервисы в интернете используют для авторизации протокол OAuth 2.0. Например Google, Яндекс, Facebook, Вконтакте.
Сервисы, использующие этот протокол авторизации, не разрешают делать к ним запросы, используя логин и пароль пользователя. Вместо этого они ожидают специальных ключей доступа. Получить эти ключи доступа может лишь пользователь, авторизовавшись в браузере. Поэтому процессы в момент исполнения не могут сами получить эти ключи и рассчитывают, что их получил проектировщик сценария в момент разработки.
Каталог «Доступ к сервисам» создан для хранения этих авторизационных ключей. Процессы в ходе исполнения получают ключи доступа из этого каталога.
Свойства
Название
Название сервиса, для идентификации в сценариях.
Коды доступа
Набор кодов доступа в формате JSON.
Каждый сервис в интернете имеет уникальный набор параметров для формирования ключей доступа. Чтобы облегчить способ получения ключей доступа мы сделали специальный сайт, на котором можно получить ключи доступа для распространенных сервисов. Сформированные ключи доступа нужно сохранить в этом поле.
Пример получения ключей доступа для сервиса Google Calendar:
Далее сайт попросит авторизоваться. Именно под этим пользователем будут исполнятся запросы к API выбранного сервиса.
Список доступных сервисов пополняется по запросу. Если вы не нашли интересующий сервис, напишите нам на [email protected]
Особенности работы
Срок годности кода доступа
Ключи доступа могут быть выданы с ограниченном сроком годности. Каждый интернет сервис самостоятельно определяет этот срок. Некоторые сервисы выдают бессрочные ключи, некоторые выдают ключи действующие несколько месяцев, другие на 1 час. Некоторые сервисы самостоятельно продлевают их при каждом запросе.
Автопродление
Некоторые сервисы разрешают продлевать просроченные ключи доступа в автоматическом режиме. Такие ключи доступа Бипиум продлевает автоматически. Если сервис не поддерживает такую возможность, то администратору системы нужно продлевать коды доступа в ручном режиме.
Сайт tokens.bpium.ru, при получении ключей доступа, сообщает срок годности ключей и возможность автопродления.
Last modified 4yr ago