Блокировка или разблокировка объектов
Этот API блокирует или разблокирует объекты по параметрам agent_id, imei или account_id. В зависимости от переданного статуса, машина будет либо заблокирована, либо активирована. Блокировка или разблокировка может быть выполнена на основании идентификаторов, таких как агент, IMEI или номер договора.
Как получить данные
Адрес запроса
Для получения данных используйте адрес: https://<server_address>/backend/api.php?
Метод
POST
Параметры запроса
Обязательные:
-
cmd=setvehblock — команда для блокировки или разблокировки машины.
-
status — статус блокировки. Значение: 0— заблокирована; 1— активна (разблокирована)
-
node — номер узла, на котором нужно выполнить команду
Один из этих параметров должен быть указан:
-
agentid — идентификатор агента
-
imei — IMEI-номер устройства
-
accountid — номер договора
Примеры запроса
Блокировка машины по IMEI:
https://<server_address>/backend/api.php?cmd=setvehblock&status=0&imei=1231231231&node=1
|
Разблокировка машины по agentid:
https://<server_address>/backend/api.php?cmd=setvehblock&status=1&agentid=2914&node=1
|
Ответ
При успешной блокировке или разблокировке машины вы получите следующий ответ:
{
"code": 0,
"data": [
{
"agentid": 2914,
"status": 1
}
],
"msg": "OK"
}
|
В ответ на API-запрос возвращается:
-
code — код ответа. Значение:— 0 — операция прошла успешно— возможные другие значения: ошибки, такие как 400 или 500, если произошли проблемы.
-
data — данные о блокировке/разблокировке
-
agentid — Идентификатор агента, для которого был изменён статус
-
status — Статус машины: 0— заблокирована; 1— активна (разблокирована)
-
msg — сообщение об успешности выполнения операции