Документация для разработчиков
Темная тема

pull.application.event.add

Scope: pull Права на выполнение: для всех

Описание

Метод для отправки событий в RT-канал приложения.

Параметры

Параметр Пример Обязательный Описание
COMMAND 'test' Да Тип события, строка.
PARAMS {JSON Object} Нет Произвольный JSON массив с данными.
MODULE_ID 'application' Нет Если отправляются команды из разных подсистем приложения, можно это указать через модуль.
USER_ID 1 или [1,2,3] Нет Если не указывать USER_ID, то данные будут отправлены в общий канал. Если указать ID пользователя, то данные будут отправлены в приватный канал.
Администратор может отправлять одновременно нескольким пользователям и в общий канал, пользователь без прав - только себе или в общий канал.

Примеры

JavaScript

BX24.callMethod('pull.application.event.add', {
	'COMMAND': 'test',
	'PARAMS': '{"param1":"value1"}',
}, function(result){
	if(result.error())
	{
		console.error(result.error().ex);
	}
	else
	{
		console.log(result.data());
	}
});

PHP

$result = restCommand('pull.application.event.add', [
	'COMMAND': 'test',
	'PARAMS': ['param1' => 'value1'],
], $_REQUEST["auth"]);

Пример ответа

{
	"result": true
}

Пример ответа при возникновения ошибки

{
	"error": "WRONG_AUTH_TYPE",
	"error_description": "Get access to application config available only for application authorization."
}

Ключи:

  • error - код возникшей ошибки
  • error_description - краткое описание возникшей ошибки

Возможные коды ошибок

Код Описание
COMMAND_ERROR Формат поля MODULE_ID не верный. Разрешены английские буквы в смешанном регистре, цифры, символ подчеркивания, точка и тире.
MODULE_ID_ERROR Формат поля MODULE_ID не верный. Разрешены английские буквы в нижнем регистре, цифры, точка и знак подчеркивания.
USER_ID_ACCESS_ERROR Указывать произвольных пользователей может только пользователь с правами администратора.
PARAMS_ERROR Передан не корректный JSON обьект.
WRONG_AUTH_TYPE Метод можно использовать только в рамках OAuth 2.0.


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024