Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

mediatype.create

Описание

object mediatype.create(объект/массив mediaTypes)

Этот метод позволяет создавать новые способы оповещения.

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Создаваемые способы оповещения.

Этот метод принимает способы оповещения со стандартными свойствами способа оповещения.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных способов оповещения, указанных в свойствеmediatypeids. Порядок возвращаемых ID совпадает с порядком переданных способов оповещения.

Примеры

Создание способа оповещения

Создание способа оповещения с типом e-mail.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "mediatype.create",
           "params": {
               "description": "E-mail",
               "type": 0,
               "smtp_server": "[email protected]",
               "smtp_helo": "company.com",
               "smtp_email": "[email protected]"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "mediatypeids": [
                   "7"
               ]
           },
           "id": 1
       }

Создание способа оповещения с пользовательским набором опций

Создание нового способа оповещения скриптом с пользовательским значением количества попыток и интервала между попытками.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "mediatype.create",
           "params": {
               "type": 1,
               "description": "Push notifications",
               "exec_path": "push-notification.sh",
               "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n",
               "maxattempts": "5",
               "attempt_interval": "11s"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "mediatypeids": [
                   "8"
               ]
           },
           "id": 1
       }

Исходный код

CMediaType::create() в frontends/php/include/classes/api/services/CMediaType.php.

Источник

CMediaType::create() в ui/include/classes/api/services/CMediaType.php.