Fuel API

End point:

https://gps.freetrack.com.ua/api/

Опис

Список доступних методів

fuel -

Приклади використання

_{*червоні параметри є обов'язковими}

Параметр	Приклад	Опис

Параметр	Приклад	Опис
auth_token	{ ваш токен авторизації }	FreeTrack token або bearer token
api_type	reports	тип запиту
api_name	fuel	метод, який викликаємо
id	777	id девайсу
dateFrom	1688158800	дата початку відліку у форматі timestamp UTC +0
dateTo	1690750799	дата кінця відліку у форматі timestamp UTC +0
gropingFuelReportBy	parking
approximateLeft	5
approximateRight	5
pointsForEndRefuel	50
minRefuel	10
minDrain	5
minimumFuelIncrease	0.8
minimumFuelDecrease	1
minSpeed	0
minSpeedDrain	0
minTimeRefuel	50
minTimeDrain	70
durationForCreationGroupOfPoints	150
durationForCreationGroupOfPoints	1
minTimeForCheckingRefuel	600
kalman	false
executeType	ignition
rangeAnalogTrigger	2000
powerExternalLimit	26
powerExternalLimit	60

Приклади відповіді

{
    "result": "ok",
    "response": {
        "durationOfMoving": 192767,
        "durationOfStop": 2399203,
        "duration": 0,
        "distance": 3080,
        "consumptionByNormative": 616.0059999999997,
        "maxSpeed": 136,
        "speedExceeds": 2009,
        "averageSpeed": 56.83540980230642,
        "fuelStart": 26.95,
        "fuelEnd": 14.63,
        "refuel": 220.21999999999997,
        "drain": 0,
        "consumption": 232.54,
        "litersPerHour": 0,
        "consumptionKm": 7.55,
        "idlingConsumption": 9.24,
        "consumptionInMotion": 226.38000000000017,
        "consumptionInMotionKm": 7.35,
        "detailLink": "?companyId=0&groupId=0&id=11750&dateFrom=1688158800&dateTo=1690750799",
        "deviceName": "Peugeot Expert *1 CAN",
        "motohours": 0,
        "parkingEngineOn": 0,
        "parkingIgnitionOn": 27642,
        "durationWithOverSpeedLimit": 181,
        "distanceWithOverSpeedLimit": 5.88,
        "monthItems": {
            "1688158800": {
                "durationOfMoving": 192767,
                "durationOfStop": 2399203,
                "duration": 0,
                "distance": 3080,
                "consumptionByNormative": 616.0059999999997,
                "maxSpeed": 136,
                "speedExceeds": 2009,
                "averageSpeed": 56.83540980230642,
                "fuelStart": 26.95,
                "fuelEnd": 14.63,
                "refuel": 220.21999999999997,
                "drain": 0,
                "consumption": 232.54,
                "litersPerHour": 0,
                "consumptionKm": 7.55,
                "idlingConsumption": 9.24,
                "consumptionInMotion": 226.38000000000017,
                "consumptionInMotionKm": 7.35,
                "monthEnd": 1690837199,
                "motohours": 0,
                "parkingEngineOn": 0,
                "parkingIgnitionOn": 27642,
                "durationWithOverSpeedLimit": 181,
                "distanceWithOverSpeedLimit": 5.88,
                "items": {
                    "1688158800": {
                        "durationOfMoving": 62,
                        "durationOfStop": 86337,
                        "workStart": 0,
                        "workEnd": 0,
                        "duration": 0,
                        "distance": 0.87,
                        "consumptionByNormative": 0.174,
                        "maxSpeed": 43,
                        "speedExceeds": 0,
                        "averageSpeed": 14.74074074074074,
                        "fuelStart": 26.95,
                        "fuelEnd": 26.18,
                        "refuel": 0,
                        "drain": 0,
                        "consumption": 0.77,
                        "litersPerHour": 0,
                        "consumptionKm": 0,
                        "idlingConsumption": 0.77,
                        "consumptionInMotion": 0,
                        "consumptionInMotionKm": 0,
                        "dayEnd": 1688245199,
                        "detailLink": "?companyId=0&groupId=0&id=11750&dateFrom=1688158800&dateTo=1688245199",
                        "motohours": 0,
                        "parkingEngineOn": 0,
                        "parkingIgnitionOn": 280,
                        "durationWithOverSpeedLimit": 0,
                        "distanceWithOverSpeedLimit": 0,
                        "items": {
                            "1688158827": {
                                "type": "stop",
                                "start": 1688158800,
                                "end": 1688235436,
                                "duration": 76636,
                                "distance": 0.04,
                                "distanceAccumulative": 0.04,
                                "consumptionByNormative": 0.008,
                                "maxSpeed": 6,
                                "speedExceeds": 0,
                                "coordinates": {
                                    "lat": 49.8258016,
                                    "lon": 23.7804083
                                },
                              ...
                            }
                          ...
                        }
                      ...
                    }
                }
            }
        }
    } 
}

Типи можливих помилок

Помилка	Поясненя

Помилка	Поясненя
[id] parameter is missing	не перданий параметр [id]
[dateFrom] parameter is missing	не перданий параметр [dateFrom]
[dateTo] parameter is missing	не перданий параметр [dateTo]
Wrong date! The [dateTo] can't be less than or equal the [dateFrom]	дата початку проміжку не може бути пізніша за дату кінця

НАВЧАЛЬНИЙ ПОСІБНИК

Fuel API

Опис

Список доступних методів

Приклади використання

Приклади відповіді

Типи можливих помилок

[id] parameter is missing

не перданий параметр [id]

[dateFrom] parameter is missing

не перданий параметр [dateFrom]

[dateTo] parameter is missing

не перданий параметр [dateTo]

Wrong date! The [dateTo] can't be less than or equal the [dateFrom]

дата початку проміжку не може бути пізніша за дату кінця