placement.bind

Scope: в зависимости от места встройки Права на выполнение: администратор

Метод установит обработчик места встраивания.

Обработчик ограничен условиями:

• запрос исполняется с авторизацией администратора,
• обработчик лежит в том же домене, что и зарегистрированный redirect_uri приложения
• каждое места встраивания привязано к праву доступа (scope). Чтобы установить обработчик места встраивания в интерфейсе CRM, дайте приложению доступ к CRM.

После установки приложений с интерфейсом необходимо выполнить метод BX24.installFinish после запроса. В противном случае кнопки не отобразятся в местах встраивания. Для серверных локальных приложений без интерфейса в Битрикс24 плейсменты отображаются сразу.

С версии rest 21.200.0 метод поддерживает многоязычность.

Параметры

Пример

https://portal.bitrix24.com/rest/placement.bind/?auth=sode3flffcmv500fuagrprhllx3soi72
	&PLACEMENT=CRM_CONTACT_LIST_MENU
	&HANDLER=http%3A%2F%2Fwww.applicationhost.com%2Fplacement%2F
	&TITLE=Demo
HTTP/1.1 200 OK
{
	"result": true
}

Пример с поддержкой нескольких языков:

CRest::call(
	'placement.bind',
	[
		'PLACEMENT' => 'PLACEMENT_CODE',
		'HANDLER' => 'https://example.com/place.php',
		'LANG_ALL' => [
			'en' => [
				'TITLE' => 'title',
				'DESCRIPTION' => 'description',
				'GROUP_NAME' => 'group',
			],
			'ru' => [
				'TITLE' => 'заголовок',
				'DESCRIPTION' => 'описание',
				'GROUP_NAME' => 'группа',
			],
		],
	]
);