REST API в коробочном Битрикс24

Коллеги, произошло то, о чем долго говорили большевики запущена поддержка REST API в коробочном Битрикс24.



Теперь решения для Битрикс24, которые опубликованы в каталоге Приложения24, доступны для установки в коробку, а это значит, что разработчикам не нужно создавать и поддерживать две версии своих продуктов.
[spoiler]

Что нужно сделать, чтобы это появилось у вас и ваших клиентов

1. Скачать обновления коробочного Битрикс24 и проинсталлировать модуль rest версии 16.6.5 (или более позднюю).
2. Удостовериться, что у вас установлен модуль intranet 16.6.4 или более поздняя версия (вообще было бы странно, если бы он у вас не стоял, но вдруг…)
3. Удостовериться, что ваш Битрикс24 доступен «снаружи» и что он также «видит» внешние ресурсы – ведь для работы приложения потребуется обращение к серверу аутентификации aouth.bitrix24.info, а также к тем внешним URL, которые нужны для работы конкретного приложения.
4. Поднять на своем сервере валидный SSL. Это обязательно, по крайней мере, для работы входящих веб-хуков, да и вообще безопасностью работы не следует пренебрегать.
   

Что получится?
После того, как выполнены вышеописанные пункты, самым волшебным образом в публичной части портала (поясню, что под публичной подразумевается та часть пользовательского интерфейса Битрикс24, которая лежит за пределами папки /bitrix) в главном меню появится подраздел Приложения, ведущий в папку https://ваш_битрикс24/marketplace/

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


Еще раз подчеркну – не надо идти в административный раздел и искать там Маркетплейс. Вы его, безусловно, найдете, но Маркетплейс в административном разделе – это каталог PHP-модулей, которые используют не REST API, а Bitrix PHP Framework. Они скачиваются в виде исходных кодов и устанавливаются в виде дополнительных модулей наряду со стандартными модулями ядра 1С-Битрикс.


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

Что нужно сделать в ваших существующих решениях, чтобы они заработали в коробке?

1. Для получения токенов авторизации ваше приложение должно запрашивать не конкретный Битрикс24, а сервер аутентификации https://oauth.bitrix.info. Эти нюансы описаны в соответствующей части курса. Дальнейшие обращения к REST остаются без изменений – по адресу конкретного Битрикс24, на котором будет установлено приложение.
2. При разработке нужно учитывать, что в отличие от облачного Битрикс24, на котором установлены все доступные обновления, включая новейшие методы и события REST, в конкретной коробочной копии версии модулей могут «отставать». Рекомендуется при установке приложения запрашивать у Битрикс24 список доступных методов http://dev.1c-bitrix.ru/rest_help/general/methods.php и либо ограничивать функционал приложения, либо выдавать предупреждение пользователю.
   

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

Буду рад обсудить этот функционал в нашем коммьюнити для разработчиков Маркетплейс и Приложений24 https://dev.bitrix24.ru/ (если вы до сих пор к нам не присоединились, то вот ваш шанс https://dev.bitrix24.ru/?secret=ksoczhx0)