При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Callback установки», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.

Callback установки

Когда у локальное приложения добавляется с опцией «Использует только API», это означает, что у него нет базового интерфейса в левом меню. Такое приложение все равно может зарегистрировать виджеты в различных местах встройки, но автоматически, сам по себе, пункт в левом меню добавлен не будет.

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

Тем не менее, несмотря на отсутствие пользовательского интерфейса, таким приложениям все равно нужно получить токены авторизации. И для этого как раз и нужен callback-обработчик, путь к которому нужно указать в поле «Путь для первоначальной установки».

Тогда, сразу после добавления локального приложения, Битрикс24 автоматически обратится к этому URL и передаст туда POST-запрос с данными авторизации OAuth 2.0, включая acces-token и refresh-token.

Предполагается, что приложение должно сохранить эти токены на своей стороне, чтобы в дальнейшем обновлять access-токен по мере необходимости.

В случае callback-обработчика установки, приложение также не должно вызывать JS-метод BX24.installFinish() как это нужно делать для локальных приложений с мастером установки.

Впрочем, даже если попытаться это сделать, то ничего не получится, поскольку это JS-метод библиотеки, которая работает только в рамках фреймов интерфейса приложения в браузере, а callback-обработчик приложения вызывается с backend Битрикс24. Никакой браузер в этом процессе не участвует.