Статичное приложение

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

В Битрикс24 такие приложения называются статичными, поскольку они представляют из себя архив с файлами в формате HTML и JS. Вызовы REST API в таких приложениях делаются на языке Java-Script.

Зайдем в кабинет разработчика и создадим новое приложение, как мы это делали в предыдущем уроке.

Нажмем кнопку «Добавить приложение». Выберем основной регион. Все эти шаги уже описывались ранее.

Выбираем тип приложения «использовать REST API», однако вместо указания ссылок на файлы, размещенные на своем сервере, прикрепляем архив с приложением. Вы можете скачать этот архив из материалов урока.

Нажмем кнопку Сохранить, а затем закрываем слайдер. Вернувшись в карточку приложения, отредактируем название приложения и сохраним изменения .

Нажимаем Протестировать. Указываем адрес своего Битрикс24, на котором являемся администратором и нажимаем Установить. Как и ранее, Битрикс24 автоматически откроет приложение после завершения установки, поскольку у нашего приложения есть пользовательский интерфейс.

Теперь давайте посмотрим подробнее, что происходит внутри.

Начнем с файла install.html.

Важно

Точно так же, как и в случае с серверным приложением, приложение должно сообщить Битрикс24, что установка прошла успешно, используя для этого js-метод installFinish из специальной js-библиотеки.

После того, как приложение вызвало эту функцию, Битрикс24 считает приложение успешно установленным и переводит пользователя на index.html из нашего архива. Этот файл является обязательным, остальные – опциональными. Вы можете включать внутрь архива свои html-страницы, css-файлы и js-библиотеки.

Вся работа с REST API производится с помощью методов специальной js-библиотеки.

В нашем примере, в частности, вызывается метод user.current, возвращающий информацию о текущем пользователе.

Важно

Помните, что вызовы REST методов, как и любые другие HTTP-запросы в Java Script, являются асинхронными. Именно поэтому обработка данных, полученных в результате вызова любого метода REST, производится в функции-обработчике.

Скелет приложения готов.

Теперь мы можем добавлять нужный пользовательский функционал в приложение, обновлять архив в карточке приложения, и переустанавливать обновленное приложение на нашем портале. А когда все будет готово и отлажено, мы сможем опубликовать решение в Битрикс24.Маркет.

REST API Битрикс24

Материалы уроку: