Контрольные точки
Список контрольных точек
GET /cars/checkpoints
Структура запроса:
GET /cars/checkpoints?token=bw3ty3h46yth
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
"description": "2222222222",
"arrivalData": 1381393740000,
"arrivedData": null,
"arrivalInterval": 1800000,
"address": "3333333333333",
"cycle": false,
"id": 1181,
"carId": 3973,
"lat": 55.75957720924986,
"lon": 48.72711181640625
},...]Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Редактирование контрольной точки
Доступно только для пользователей с правами администратора
PUT /cars/checkpoints/id
Структура запроса:
PUT /cars/checkpoints/1?token=bw3ty3h46yth
id: id контрольной точки
token: ключ доступа
Формат: json
{
"id": 1,
"address": "Новый адрес",
"arrivalData": 1384862460000,
"arrivalInterval": 600000,
"carId": 1,
"description": "description",
"lat": 55.79819333412856,
"lon": 48.702392578125
}
// id контрольной точки, целое число
// адрес, строка
// время прибытия, timestamp
// интервал прибытия, целое число
// id ТС, целое число
// описание, строка
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"description": "emulating in progress..",
"arrivalData": 1416470760000,
"arrivedData": 1416470781000,
"arrivalInterval": 600000,
"address": "New address",
"cycle": false,
"id": 99345,
"carId": 134375,
"lat": 61.81466389468391,
"lon": 34.365234375
}
// описание, строка
// время прибытия, timestamp
// интервал прибытия, timestamp
// адрес, строка
// id, целое число
// id ТС, целое число
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
Статус: 400 — ошибка в запросе
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Создание контрольной точки
Доступно только для пользователей с правами администратора
POST /cars/checkpoints
Структура запроса:
POST /cars/checkpoints?token=bw3ty3h46yth
token: ключ доступа
Формат: json
{
"address": "адрес",
"arrivalData": 1384862520000,
"arrivalInterval": 600000,
"carId": 4034,
"description": "описание",
"lat": 56.01757535614987,
"lon": 49.23316955566406
}
// адрес, строка
// время прибытия, timestamp
// интервал прибытия, целое число
// id ТС, целое число
// описание, строка
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"address": "Полный адрес",
"arrivalData": 1386152820000,
"arrivalInterval": 600000,
"arrivedData": null,
"car": null,
"carId": 4820,
"cycle": false,
"description": "test desc",
"id": 1421,
"lat": 55.67835873246176,
"lon": 49.1748046875
}
// адрес, строка
// время прибытия, timestamp
// интервал прибытия, целое число
// ТС
// id ТС, целое число
// описание, строка
// id контрольной точки, целое число
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
Статус: 400 — ошибка в запросе
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Удаление контрольной точки
Доступно только для пользователей с правами администратора
DELETE /cars/checkpoints/{id}
Структура запроса:
DELETE /cars/checkpoints/25?token=bw3ty3h46yth
id: id контрольной точки
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Контрольные точки определенного ТС
GET /cars/{id}/checkpoints
Структура запроса:
GET /cars/4034/checkpoints?token=bw3ty3h46yth
id: id машины
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
"description": "home",
"arrivalData": 1427361720000,
"arrivedData": null,
"arrivalInterval": 600000,
"address": "",
"cycle": false,
"id": 128601,
"carId": 4034,
"lat": 55.76002392688244,
"lon": 49.171940088272095
},...]
// описание, строка
// время прибытия, timestamp
// интервал прибытия, целое число
// адрес, строка
// id контрольной точки, целое число
// id ТС, целое число
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки