77  /  80

Подписка на события

Просмотров: 1948 (Статистика ведётся с 06.02.2017)

Интерфейс REST API позволяет устанавливать свои обработчики серверных событий.

Обработчиком события служит URL, который будет вызван после того, как пользователь произведет запрошенное действие на портале Битрикс24, на котором установлено приложение.

Обработчик получает на вход следующие данные:

  • event - имя сработавшего события.
  • data - массив данных события.
  • auth - набор данных для авторизации.

Обработчик может:

  • Использовать полученные данные авторизации для выполнения запросов к REST API.
  • Быть установлен только пользователем с правами администрирования портала.

Внимание! Если обработчику события требуется обращение к Rest API для работы с данными, то настоятельно рекомендуется использовать для этого именно переданные данные авторизации, а не сохраненные на стороне приложения..


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

Обработчик события будет вызван не сразу после срабатывания события, а через некоторое время, зависящее от нагрузки.

Список доступных событий можно получить при помощи REST-метода events.


Установка обработчика события производится:

  • при помощи REST-метода event.bind на основе restCommand:
    $handlerBackUrl  = 'http://www.my-domain.ru/handler/';
    $result = restCommand('event.bind', Array(
       'EVENT' => 'OnAppUpdate',
       'HANDLER' => $handlerBackUrl
    ), $_REQUEST["auth"]);
    
  • или при помощи функции BX24.callBind js-библиотеки:
    BX24.callBind('OnAppUpdate', 'http://www.my-domain.ru/handler/');
    

    Получение списка зарегистрированных обработчиков событий производится при помощи REST-метода events.get.

    Снятие зарегистрированного обработчика события производится при помощи REST-метода event.unbind или при помощи функции BX24.callUnbind js-библиотеки.

    Для доступа к каждому событию при регистрации версии приложения должно быть запрошено соответствующее событию право доступа.

    Приложение может установить произвольное количество обработчиков одного и того же события, но все обработчики должны быть установлены с авторизацией различных пользователей. Кроме того, вызов обработчика события может зависеть от доступа пользователя, чья авторизация будет выдана обработчику.

    Имена событий регистронезависимы.

    Внимание! При деинсталляции приложения или при установке новой версии все обработчики событий, установленные приложением, будут удалены.



    1
    Курсы разработаны в компании «1С-Битрикс»