Статус транспортного средства

 
Этот API используется для получения актуальной информации о текущем статусе одного или нескольких транспортных средств, включая данные о местоположении, скорости, показаниях датчиков и техническом состоянии.

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

Метод

GET

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

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

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

Чтобы получить нужные данные, добавьте к адресу запроса параметры. Параметры указываются после знака вопроса «?» и разделяются знаком «&».
  • cmd = status— команда для получения информации о статусе
https://<address>/api/api.php?cmd=status
  • imei — уникальный идентификатор GPS-трекера
  • agents — список идентификаторов agentid, указывается через запятую для запроса статусов нескольких объектов
  • veh_numbers — регистрационный номер транспортного средства, точно как он указан в системе с обязательным соблюдением регистра букв и цифр
    В запросе должен присутствовать один из трёх параметров: imei, agents или veh_numbers.

Примеры

Пример 1: Запрос по IMEI

https://<address>/api/api.php?cmd=status&imei=357073296325265

Пример 2: Запрос по нескольким идентификаторам агентов

https://<address>/api/api.php?cmd=status&agents=51594,44841

Ответ на API

{
  "code": 0,
  "msg": "OK",
  "data": [
    {
      "agentid": 44841,
      "imei": "865473034076573",
      "configuration": "Teltonika FM2200",
      "typeid": 27,
      "type": "Car",
      "vehiclenumber": "NURKA",
      "folder": "REAL",
      "created_time": 1518167398,
      "uniqid": "865473034076573",
      "current_mileage": 65345,
      "initial_mileage": 0,
      "driver_name": null,
      "driver_phone": null,
      "model": "ВАЗ (Lada) Kalina",
      "info": " test",
      "vin": "XTA219470K0259832",
      "status": {
        "active": 1,
        "speed": 0,
        "direction": 27,
        "lat": "47.119755",
        "lon": "39.667492",
        "alt": 0,
        "satsinview": 16,
        "unixtimestamp": "1621432378",
        "moving": 0,
        "parking": 9267,
        "firing": 0
      },
      "sensors_status": [
        {
          "name": "Ignition sensor",
          "id": "150549",
          "hum_value": "выкл.",
          "dig_value": "0",
          "raw_value": "12494",
          "change_ts": "1621423461",
          "group": "GROUP!"
        },
        {
          "name": "Датчик топлива",
          "id": "368013",
          "hum_value": "1249.4 -",
          "dig_value": "1249.4",
          "raw_value": "12494",
          "change_ts": "1621432378",
          "group": "myGroup"
        }
      ]
    }
  ],
  "reqest_time": 0.0642
}

Параметры ответа

Ответ возвращается в формате JSON и содержит:
 imei — уникальный номер трекера
  • distance — пройденное расстояние за указанный период
  • agent_id —  идентификатор устройства слежения
  • account_id — номер аккаунта в системе
  • code — код статуса (0 - успех)
  • msg — сообщение о статусе выполнения запроса
  • data — массив объектов с информацией о транспортных средствах:
  • agentid — идентификатор договора
  • imei — международный идентификатор устройства слежения
  • vin — идентификационный номер транспортного средства
  • configuration — модель трекера
  • typeid — числовой идентификатор типа транспортного средства
  • type — тип транспортного средства
  • vehiclenumber — регистрационный номер транспортного средства
  • folder — организационная группа или филиал
  • created_time — время создания в формате Unixtimestamp
  • uniqid — уникальный идентификатор
  • current_mileage — текущий пробег
  • initial_mileage — начальный пробег
  • driver_name — имя водителя
  • driver_phone — телефон водителя
  • model — модель транспортного средства
  • info — дополнительная информация
  • status — информация о текущем состоянии:
  • active — активен ли объект (1 или 0)
  • speed — текущая скорость
  • direction — текущее направление в градусах
  • lat — текущая широта
  • lon — текущая долгота
  • alt — текущая высота
  • satsinview — количество видимых спутников
  • unixtimestamp — время последнего обновления
  • moving — время в движении в секундах
  • parking — время парковки в секундах
  • firing — состояние зажигания (1 — включено, 0 — выключено)
  • sensors_status — массив с информацией о датчиках:
  • name — название датчика
  • id — идентификатор датчика
  • hum_value — реальное значение после калибровки
  • dig_value — цифровое значение после калибровки
  • raw_value — необработанное значение до калибровки
  • change_ts — время последнего изменения значения Unixtimestamp-формате
  • group — группа датчика
  • reqest_time — время выполнения запроса в секундах