Automap — rest — controlPoints

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
},...]

// описание, строка
// время прибытия, timestamp

// интервал прибытия, целое число
// адрес, строка

// id контрольной точки, целое число
// id ТС, целое число
// широта, число с плавающей точкой
// долгота, число с плавающей точкой

Статус: 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/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

Содержит описание ошибки