End point:
...
distance
- отримання пройденої дистанції
Приклади використання
*червоні параметри є обов'язковими
Один девайс/rілька девайсів з однаковими датами
Параметр | Приклад | Опис |
---|---|---|
auth_token | { ваш токен авторизації } | POST/GET параметр або bearer token |
api_type | reports | тип запиту |
api_name | distance | метод, який викликаємо |
id | 777,555 | id об'єкту (через кому, якщо потрібно передати кілька) |
dateFrom | 1689022800 | дата початку відліку timestamp UTC +0 |
dateTo | 1689454799 | дата кінця відліку timestamp UTC +0 |
Кілька девайсів з різними датами
Параметр | Приклад | Опис |
---|---|---|
auth_token | { ваш токен авторизації } | POST/GET параметр або bearer token |
api_type | reports | тип запиту |
api_name | distance | метод, який викликаємо |
devices | [{ "id": 11750, "dateFrom": 1689022800, "dateTo": 1689454799 }, {"id": 8437, "dateFrom": 1690837200, "dateTo": 1692056800 } ] | дані про девайси у форматі JSON |
Приклади відповіді
Один девайс
Code Block | ||
---|---|---|
| ||
{ "result": "ok", "response": [ { "deviceID": 777, "dateFrom": 1689022800, "dateTo": 1689454799, "distance": 465.95 } ] } |
...
Code Block | ||
---|---|---|
| ||
{ "result": "ok", "response": [ { "deviceID": 11750777, "dateFrom": 1689022800, "dateTo": 1689454799, "distance": 0723.8 }, { "deviceID": 8437888, "dateFrom": 1690837200, "dateTo": 1692056800, "distance": 0296.01 } ] } |
Опис відповіді
Параметр | Опис |
---|---|
deviceID | id об'єкту |
dateFrom | дата початку відліку timestamp UTC +0 |
dateTo | дата кінця відліку timestamp UTC +0 |
distance | дистанція, пройдемо об'єктом в часових межах |
Типи можливих помилок
Помилка | Поясненя |
---|---|
[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] | дата початку проміжку не може бути пізніша за дату кінця |
Error in device list | неправильно складений JSON документ зі списком девайсів |