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

Эта встройка не имеет в интерфейсе кнопки, которая позволяет пользователю открыть её самостоятельно. Приложение может отправить ссылку на свою встройку. Для использования данной встройки ссылка должна быть в формате /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-клиента, подробности читайте здесь,
• регистрацию для отдельных пользователей.