Устройство

Можно получить все данные о приборе.

Метод devices - Получение информации об устройстве.

POST https://plus.auto-scan.ru/api/devices

Можно получить данные о последней геопозиции, скорости, времени.

Параметры

ИмяТипОписание
device_idsarrayМассив из N-int, где каждое значение device_id устройства
load_ioboolЗагружать входы-выходы устройства (по умолчанию False)

Результат

В случае успеха возвращает JSON вида:

{
  "ok": True,
  "devices": [device],
  "device_tree": [device_tree],
}

Тип device

ИмяТипОписание
idintID номер устройства в системе А+
onlineboolНа связи ли устройство сейчас
serialstrСерийный номер устройства
firmware_versionarrayМассив из двух чисел [версия аппаратная, версия прошивки * 100]
timezoneintЧасовая зона устройства
work_statedict | nullДанные о пробеге WorkState
sim_numberstr | nullНомер сим-карты (ЗАПОЛНЯЕТСЯ ПОЛЬЗОВАТЕЛЕМ)
imeistrIMEI устройства
last_gpsarray | nullМассив с последними 5 GPS-точками
autoscan_settingsdict | nullНастройки со старой версии ПО

 

Тип WorkState

ИмяТипОписание
mileagedictСловарь типа WorkStateItem с данными о пробеге
moto_houtsdictСловарь типа WorkStateItem с данными о моточасах
day_in_operationdictСловарь типа WorkStateItem с данными о днях в эксплуатации

Тип WorkStateItem

ИмяТипОписание
user_counteddictДанные, посчитанные для пользователя в виде {"value": float, "time": Unixtime}. Обновляются по запросу от пользователя и раз в сутки.
server_counteddictДанные, посчитанные сервером в виде {"value": float, "time": Unixtime}. Обновляются раз в сутки.
edit_historyarrayМассив из dict’ов вида {"time": Unixtime, "old_value": float, "value": float}, где отображена история ручных изменений значения.

 

Тип GPSPoint

ИмяТипОписание
timeUnixtimeВремя записи GPS-точки
providerintЕсли GPS, то 0; Если GSM (LBS), то 1
xfloat | nullЗначение градусов по долготе (longtitude)
yfloatЗначение градусов по широте (latitude)
speedfloat | nullСкорость в км/ч
singleboolЕсли точка не одиночная, то False.
satellitesint | nullКоличество спутников

Тип AutoscanSettings

ИмяТипОписание
regstr | nullНомер устройства в старой системе Автоскан
numberstrГос.номер устройства
paramsdict{... "Model": str, ...} Словарь с параметрами, в Model лежит Марка ТС

Пример

import requests

result = requests.post(
    'https://plus.auto-scan.ru/api/devices',
    auth=('demo', 'demo'),
    headers={'X-ZONT-Client': 'your@email', },
    json={"device_ids": [10778],}
).json()

device = result["devices"][0]

print(device)
# {
#	  ...
#     "id": 10778,
#     "online": True,
#     "serial": "demo-a200-3",
#     "firmware_version": [321, 221],
#     "timezone": 3,
#     "work_state": {
#         "mileage": {
#             "user_counted": {"value": 3855.4133551030004, "time": 1611819000},
#             "server_counted": {"value": 3356.31189432, "time": 1611819000},
#             "edit_history": [{"time": 1611045777, "old_value": 0.0, "value": 1000.0}],
#         },
#         "moto_hours": {
#             "user_counted": {"value": 201.0, "time": 1611819000},
#             "server_counted": {"value": 201.0, "time": 1611819000},
#             "edit_history": [
#                 {"time": 1611045800, "old_value": 0.0, "value": 100.0},
#                 {"time": 1611046518, "old_value": 100.0, "value": 101.0},
#             ],
#         },
#         "day_in_operation": {
#             "user_counted": {"value": 387.5998148136, "time": 1611897111},
#             "server_counted": {"value": 387.5998148136, "time": 1611897111},
#             "edit_history": [],
#         },
#     },
#     "sim_number": "+7(831)2207676",
#     "imei": "123456789012345",
#     "last_gps": [
#         {
#             "time": 1611903524,
#             "provider": 0,
#             "x": 46.10445,
#             "y": 51.58298333333333,
#             "speed": 7.0,
#             "single": False,
#             "satellites": None,
#         },
#         {
#             "time": 1611903521,
#             "provider": 0,
#             "x": 46.10431666666667,
#             "y": 51.58291666666667,
#             "speed": 13.0,
#             "single": False,
#             "satellites": None,
#         },
#         {
#             "time": 1611903518,
#             "provider": 0,
#             "x": 46.1042,
#             "y": 51.58283333333333,
#             "speed": 16.0,
#             "single": False,
#             "satellites": None,
#         },
#         {
#             "time": 1611903517,
#             "provider": 0,
#             "x": 46.104166666666664,
#             "y": 51.5828,
#             "speed": 13.0,
#             "single": False,
#             "satellites": None,
#         },
#         {
#             "time": 1611903515,
#             "provider": 0,
#             "x": 46.10415,
#             "y": 51.58273333333333,
#             "speed": 11.0,
#             "single": False,
#             "satellites": None,
#         },
#     ],
#     "autoscan_settings": {
#								...
#                              "reg": 2000000001,
#                              "number": "А123БВ",
#                              "params": {
#									...
#                                  "Model": "Автоскан А100",
#                              },
#                          }
#