End point:End point:
https://gps.freetrack.com.ua/api/
...
fuel-SE- вибираємо перше входження пристроїв в множину геозон
Приклади використання
*червоні параметри є обов'язковими
Параметр | Приклад | Опис |
|---|---|---|
auth_token | { ваш токен авторизації } | POST/GET параметр або Bearer Authentication |
api_type | reports | тип запиту |
api_name | fuel-SE | метод, який викликаємо |
data | data=[{ "deviceID": |
"checkGeozones":false, "timeIntervals":["1704146400,1704232799","1702300820,1702329989","1702329989,1702330944"]}, {"deviceID": |
|
дані для завантаження звіту… deviceID - ід пристрою, checkGeozones - по замовчуванню = false, не обов'язковий параметр, який каже чи потрібно перевіряти входження в геозони… timeIntervals - часові інтервали для обраного пристрою. |
Приклад правильної відповіді
| Code Block | ||
|---|---|---|
| ||
{
"result": "ok",
"response": {
"108797777": {
"intersectionData": [],
"intervals": [
{
"dateFrom": 1704146400,
"intervals": [ "dateTo": 1704232799,
{ "result": {
"dateFrom": 1704146400, "dateTodurationOfMoving": 17042327994687,
"resultdurationOfStop": {2405,
"durationOfMovingdistance": 2148047.89,
"durationOfStopaverageSpeed": 6491931.48421052631579,
"distanceconsumption": 332.810,
"averageSpeedconsumptionKm": 47.5788590604026850,
"consumptionconsumptionInMotion": 0,
"zones": {
"8756": "РадехівБаза ЦЗ"
},
"distanceForSpeed": {
"speedDiapasones": {
"10": {
"distance": 3.73,
"duration": 1968
},
"20": {
"distance": 11.91,
"duration": 2557
},
"30": {
"distance": 12.79,
"duration": 1714
},
"40": {
"distance": 14.52,
"duration": 1523
},
"50": {
"distance": 21.64,
"duration": 1989
},
"60": {
"distance": 27.62,
"duration": 1883
},
"70": {
"distance": 32.34,
"duration": 1928
},
"80": {
"distance": 45.81,
"duration": 2228
},
"90": {
"distance": 53.51,
"duration": 2291
},
"100": {
"distance": 76.22,
"duration": 2902
},
"over_100": {
"distance": 32.72,
"duration": 1165
}
},
"speedDiapasonesDistance": 332.81,
"speedDiapasonesDuration": 22148,
"speedDiapasonesDinstanceMax": 76.2235459236999,
"speedDiapasonesDurationMax": 2902
}
}
}
]
}
}
} |
Опис відповіді
Параметр | Опис |
|---|---|
11111, 22222, 33333 | ID пристрою |
geozones | список геозон, які перевірялись |
geozoneID | ID геозони, яка перевірялась |
in | час в'їзду у форматі timestamp (UTC), цей час може бути менший за той, який ми передали у запиті (якщо авто уже стояло в даній геозоні), може бути null, якщо авто ні разу не в'їжджало геозону |
out | час виїзду у форматі timestamp (UTC), може бути null, якщо авто ні разу не виїжджало геозону |
Приклад неправильної відповіді
| Code Block |
|---|
{
"result": "ok",
"response": {
"11111": {
"geozones": [
{
"geozoneID": -1,
"errorMessage": "Can`t find ['geozoneID'] at the item list"
},
{
"geozoneID": 555,
"errorMessage": "Wrong Timestamp"
},
{
"geozoneID": 666,
"errorMessage": "Can`t find ['start'] at the item list"
}
]
},
"33333": {
"errorMessage": "User has not permission on the object with ID [134]"
},
"22222": {
"errorMessage": "Can`t find ['geozones'] at the item list"
},
"-1": {
"errorMessage": "Can`t find ['deviceID'] at the item list"
}
}
} |
Типи можливих помилок
...
Помилка
...
Помилка | Пояснення |
|---|---|
Can`t parse the parameter - [data] | не перeданий параметр [data] |
Can`t find ['deviceID'] at the item list | не перeданий ключ [deviceID], “-1” замість ID пристрою у відповіді |
User has not permission on the object with ID [33333] | нема доступу до об'єкту з ID [33333] |
Can`t find ['geozones'] at the item list | не переданий ключ [geozones] |
Can`t find ['geozoneID'] at the item list | не перeданий ключ [geozoneID] |
Can`t find ['start'] at the item list | не переданий ключ [start] |
Wrong Timestamp | неправильний формат дати: дата має бути у форматі timestamp (UTC), не раніше, ніж поточний рік і не пізніше 2000 року |