×
  («Скай Электроникс», 2025

API для получения данных об экодрайвинге

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

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

Метод

GET

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

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

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

Чтобы получить нужные данные, добавьте к адресу запроса параметры. Параметры указываются после знака вопроса «?» и разделяются знаком «&».
  • cmd = mileco_drive — команда для получения данных о поездке 
  • start — дата и время начала периода, за который вы хотите получить данные
  • stop — дата и время окончания периода
Время указывается в формате Unixtimestamp — это количество секунд, прошедших с 1 января 1970 года.
  • vehid — идентификатор транспортного средства, по которому необходимо получить данные. Если  нужно получить данные об одной машине —  введите её  ID, если о нескольких машинах — перечислите их ID через запятую.
    Если вы не укажете параметр vehid, система автоматически выдаст информацию по всем машинам, закреплённым за вашим аккаунтом.
  • imei — уникальный номер GPS-трекера транспортного средства. Используйте этот параметр для получения данных по конкретному трекеру.
    При указании imei параметр vehid указывать не нужно.
Пример API-запроса с imei:
https://<address>/api/api.php?cmd=mileco_drive&start=1738113401&stop=1738631801&time_diff_type=1&imei=86645655031889725
  • time_diff_type — группировка данных по времени. По умолчанию данные собираются за каждый день.
  • time_diff_type=1 — данные будут собраны за каждые 7 дней
  • time_diff_type=2 — данные будут собраны за каждый месяц

Пример

API-запрос

 https://<url>/api/api.php?cmd=mileco_drive&start=1738113401&stop=1738631801&time_diff_type=1&vehid=32,53     

Ответ на API

{
    "32": {
        "29.01.2025_01:16|04.02.2025_01:16": {
            "date": "Wednesday, 29.01.2025 01:16 - Tuesday, 04.02.2025 01:16",
            "veh_id": 32,
            "distance": 842.75354055,
            "agent_id": 545,
            "account_id": 10025,
            "account_name": "ИП Иванов",
            "veh_name": "О 511 ГР 123",
            "veh_type": "Car",
            "eco_data": {
                "speed": {
                    "msg": "Speed",
                    "cnt": 0,
                    "val": 1290,
                    "fee": 12
                }
            }
        }
    }
    "53": {
        "29.01.2025_01:16|04.02.2025_01:16": {
            "date": "Wednesday, 29.01.2025 01:16 - Tuesday, 04.02.2025 01:16",
            "veh_id": 53,
            "distance": 8.24949075,
            "agent_id": 545,
            "account_id": 10025,
            "account_name": "ИП Иванов",
            "veh_name": "О 619АК 67",
            "veh_type": "Bus",
            "eco_data": []
        }
    }   

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

В ответ на API-запрос возвращаются данные о каждом транспортном средстве:
  • veh_id — идентификатор транспортного средства
  • imei — уникальный номер трекера
  • distance — пройденное расстояние за указанный период
  • agent_id —  идентификатор договора
  • account_id — номер аккаунта в системе
  • account_name —  имя аккаунта
  • veh_name — название транспортного средства
  • veh_type — тип транспортного средства
  • eco_data — данные о вождении