×

Добавление транспортного средства в договор

 
Чтобы добавить объект в аккаунт, используйте этот API.

Пример

API-запрос

https://<address>/backend/api.php?cmd=vehadd&account_id=4019&type=1&name=testveh&imei=80987898789987&vehmodel=13&msisdn=7903
 

Как получить данные

Метод

POST

Адрес запроса

Для получения данных используйте адрес:  https://<address>/backend/api.php?
<address>— адрес сайта

Параметры запроса

Чтобы получить нужные данные, добавьте к адресу запроса параметры. Параметры указываются после знака вопроса «?» и разделяются знаком «&».

Обязательные параметры

  • cmd = vehadd — команда для добавления транспортного средства
  • account_id: — номер договора в системе
  • vehmodel — модель устройства мониторинга. ID модели берётся из ответа команды vehmodellist
  • imei — уникальный номер устройства мониторинга
  • type — тип транспортного средства. ID типа транспортного средства берётся из ответа команды vehtypelist. Если требуемый тип отсутствует в списке, можно указать новый ID
  • name — государственный номер или название транспортного средства
  • msisdn — номер основной SIM-карты устройства
  • msisdn2 — номер второй SIM-карты устройства
  • mac — MAC-адрес, идентификатор устройства автокондуктора.  Если указан параметра mac система автоматически создаст запись об объекте во вкладке «Автобусы» в панели администратора. 

Дополнительные параметры

  • folder — название папки для добавления транспорта. Если указанной папки нет — будет создана. Если папка не указана, транспорт будет добавлен в общий список — корневую папку
  • info — дополнительная информация о транспорте
  • summer_fuel — расход топлива в летний период
  • winter_fuel — расход топлива в зимний период
  • fuel_type — тип используемого топлива . 50-дизель, 80-92-95-98-бензин, 100-газ. Если параметр не указан, система автоматически установит дизель
  • lost_connection_time — время, после которого фиксируется потеря связи (в секундах)
  • time_zone — часовой пояс транспорта. По умолчанию устанавливается Europe/Moscow
  • initial_motor_hours — начальные показания моточасов
  • driver_id — идентификатор водителя
  • initial_mileage — начальный пробег транспорта. Если не указан, считается с нуля
  • speed_limit — максимально допустимая скорость. Если не указана, контроль скорости отключён
  • minsat — минимальное количество спутников. По умолчанию установлено 4
  • maxhdop — максимальный HDOP. По умолчанию установлено 21
  • mintime — минимальное время стоянки для разбития треков. По умолчанию установлено 3600 секунд
  • maxspeed — максимально возможная скорость. По умолчанию установлено 250
  • minspeed — минимальная скорость для детектирования начала движения. По умолчанию установлено10 км/ч
  • minparking — минимальное время парковки на маршруте. По умолчанию установлено 300 секунд
  • model — марка и модель транспорта
  • year — год выпуска транспорта. Если год выпуска не указан, по умолчанию он будет считаться 1900 годом
  • vin — идентификационный номер транспорта
  • engine_horse: — мощность двигателя
  • organization — название организации-владельца
  • column — номер колонки
  • subdivision — подразделение

Ответ на запрос

Ответ на API

{
 "code": 0,
 "msg": "OK",
 "agent_id": "20518",
 "veh_id": "18994"
}
В ответ на API-запрос возвращается
  • code — код ответа, который показывает, как запрос был обработан
  • msg — сообщение с текстовым описанием результата операции
  • agent_id — идентификатор агента, который обработал запрос
  • veh_id — идентификатор транспортного средства, к которому относится этот ответ