update_operating
Для запуска или остановки ретранслятора или ретрансляции за прошедший период используйте метод retranslator/update_operating:
svc=retranslator/update_operating¶ms={"itemId":<long>,
"operate":<bool>,
"stopTime":<uint>,
"timeFrom":<uint>,
"timeTo":<uint>,
"callMode":<text>
}
Параметры
Запрос может содержать следующие параметры. Обязательные параметры отмечены звездочкой (*).
| Название | Описание |
|---|---|
| itemId* | ID ретранслятора. |
| operate* | Запуск или остановка ретрансляции: true — запуск, false — остановка. Также принимаются значения 1 и 0. |
| callMode | Установите callMode в значение switch для запуска или остановки ретранслятора. Установите callMode в значение history для запуска или остановки ретрансляции за прошедший период. Если не указано, значение по умолчанию — switch. |
| stopTime | Время, когда ретрансляция будет остановлена автоматически. Можно использовать при callMode=switch и operate=true. Необязательный параметр. |
| timeFrom | Начало интервала, за который должны ретранслироваться данные. Время UNIX. Обязательно только при callMode=history и operate=true. |
| timeTo | Окончание интервала, за который должны ретранслироваться данные. Время UNIX. Обязательно только при callMode=history и operate=true. |
Ответ
В случае успешного выполнения запроса возвращается ответ следующего формата:
{
"rtro":<int>, /* 0 — остановлен, 1 — запущен */
"rtrst":<uint> /* Время, когда ретрансляция останавливается. Время UNIX. */
}
В противном случае возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры или не удалось запустить/остановить ретранслятор. |
| 7 | Ретранслятор не найден или у пользователя отсутствует право доступа ADF_ACL_AVL_RETR_EDIT_SETTINGS на ретранслятор (Редактирование свойств ретранслятора, включая запуск/остановку). |