Обновление документации в марте 2020

Добрый день!

Подскажите, пожалуйста, насчет "REST_APP_URI позволяет встроить ваше приложение в любое место Битрикс24". Это же абсолютно новая функциональность? Мы в компании довольно часто разрабатываем приложения для Битрикс24, поэтому периодически я мониторил места для встраивания, чтобы рассказывать, что можно сделать, а что нельзя. И раньше я такого не замечал.

И второй вопрос, более по существу. Как этой штукой пользоваться то? Из описания вообще не понятно. Конечно я сам попробую поиграть с этой опцией и посмотрю, что примерно нам это дает, но хотелось бы получить ответ от профессионалов и разработчиков этой возможности. Пока из всего, что я понял:
* можно встроиться в "любое" место
* никакого визуального интерфейса при этом от приложения не будет (?)

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


Заранее благодарю за объяснения!

Данный пример регистрирует на вашем портале встройку, для данного PLACEMENT можно на портале зарегистрировать её только один раз, после этого она становится доступна для вызова:
в вашем приложении вы можете разместить вашу встройку:

разместить её в посте живой ленты:отправить её с помощью бота в чат пользователю методом:
ссылку можно вставить в любое текстовое поле, которое поддерживает BBCode или внутри ваших других встроек как обычная ссылка, а с помощью GET параметра params вы можете изменять отображаемые данные в стройке и использовать эту возможность в абсолютно разных сценариях передавая любое количество параметров в GET ключе params, например: ?params[test]=yy

Добавим это в документацию.

Если честно, до сих пор не понял, как это работает

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

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

Еще раз спасибо!

Короче: это еще один iframe. По факту это открытие "специальной" части приложения из любого места.
Если вы установили приложение то доступ к нему (конфигурационные файлы) ограничен и встроиться вы можете только в места встройки (т.е. показать публичную часть своего iframe).

Эта штука является некоторым промежуточным моментом между "по правам не видишь приложение" и "места встройки и т.п.".

Кастомизировать портал она НЕ позволяет