Встраивание приложений

Эта встройка не имеет в интерфейсе кнопки, которая позволяет пользователю открыть её самостоятельно. Приложение может отправить ссылку на свою встройку. Для использования данной встройки ссылка должна быть в формате /marketplace/view/#APP_CODE#/, где #APP_CODE# - код вашего приложения.

Встройка может принимать любое количество параметров в get ключе params, например: /marketplace/view/#APP_CODE#/?params[test]=y. В этом случае в PLACEMENT_OPTIONS будет равен:

[
'test' = 'y'
]

[url=/marketplace/view/'.$myApp['CODE'].'/?params[test]=y]uri[/url]

<?
$placement = 'REST_APP_URI';
$url = 'https://example.com/placement.php';
CRest::call(
	'placement.bind',
	[
		'PLACEMENT' => $placement,
		'HANDLER' => $url
	]
);
?>

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

<a href="/marketplace/view/<?=$myApp['CODE']?>/">uri</a>

И разместить её в посте живой ленты:

<?
	CRest::call('log.blogpost.add',
		[
			'POST_TITLE' => 'Post Title',
			'POST_MESSAGE' => 'use this [url=/marketplace/view/'.$myApp['CODE'].'/?params[test]=y]uri[/url]',
			'DEST' => [ 'UA' ]
		]);
?>

И отправить её с помощью бота в чат пользователю методом:

<?
CRest::call(
	'imbot.message.add',
	[
		'DIALOG_ID' => 1,
		'MESSAGE' => 'use this [url=/marketplace/view/'.$myApp['CODE'].'/?params[test]=y]uri[/url]',

	]
);
?>

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

• errorHandlerUrl - обязательное поле с URL обработчика ошибки. Если встройка долго грузится (дольше 3-5 сек), на этот URL приходит событие с текстом и кодом ошибки, а сама встройка удаляется.

Пример регистрации:

CRest::call(
	'placement.bind',
	[
		'PLACEMENT' => 'PAGE_BACKGROUND_WORKER',
		'HANDLER' => 'http://portal.vlads.bx/vlads/placement/?ty=1',
		'OPTIONS' => [
			'errorHandlerUrl' => 'http://portal.vlads.bx/vlads/logg.php?ty=1',
		],
		'LANG_ALL' => [
			'ru' => [
				'TITLE' => 'test',
			]
		]
	]
);

Данное место встройки поддерживает:

• специальные JS-методы и события для встройки внешнего WebRTC-клиента, подробности читайте здесь,
• регистрацию для отдельных пользователей.