send_cmd
Чтобы отправить команду на объект, используйте метод unit/send_cmd.
svc=unit/send_cmd¶ms={
"itemId": <long>,
"commandType": <text>,
"commandName": <text>,
"linkType": <text>,
"param": <text>,
"timeout": <uint>,
"flags": <uint>
}
Параметры
Обязательные параметры отмечены звездочкой (*).
| Параметр | Описание |
|---|---|
itemId* |
ID объекта. |
commandType* |
Тип команды (см. ниже). |
commandName |
Имя команды. Если оно не указано, в качестве имени используется тип команды. |
linkType* |
Канал, по которому нужно отправить команду (см. ниже). |
param* |
Параметры команды. |
timeout* |
Время ожидания команды в очереди, в секундах. |
flags |
Флаги выбора номера телефона для выполнения команды: 0: использовать любой (сначала основной, затем дополнительный); 0x1: использовать основной; 0x2: использовать дополнительный; 0x10: передать param в формате JSON. |
Типы команд
| Тип команды | Описание |
|---|---|
block_engine |
Заблокировать двигатель. |
unblock_engine |
Разблокировать двигатель. |
custom_msg |
Отправить произвольное сообщение. |
driver_msg |
Отправить сообщение водителю. |
download_msgs |
Загрузить сообщения. |
query_pos |
Запросить местоположение объекта. |
query_photo |
Запросить фотографию. |
output_on |
Активировать выход. |
output_off |
Деактивировать выход. |
send_position |
Отправить координаты. |
set_report_interval |
Установить интервал отправки данных. |
upload_cfg |
Загрузить конфигурацию. |
upload_sw |
Загрузить прошивку. |
Каналы
| Значение | Канал |
|---|---|
| Пустая строка | Авто |
tcp |
TCP |
udp |
UDP |
vrt |
Виртуальный |
gsm |
SMS |
Пример
Ниже приведен пример запроса unit/send_cmd.
svc=unit/send_cmd¶ms={"itemId":1351,"commandType":"custom_msg","commandName":"pin","linkType":"","param":"pin 0000","timeout":60,"flags":0}
Ответ
Если запрос выполнен успешно, возвращается пустой ответ.
{ }
В противном случае возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры. |
| 5 | Ошибка при отправке команды. |
| 7 | Объект не существует, или у пользователя нет всех следующих прав доступа на него: Просмотр команд, Создание, редактирование и удаление команд и Отправка команд. |