Automap — rest — carGroups (before delete /wheel)

Группы ТС

Список групп ТС

GET /cars/groups

Структура запроса:

GET /cars/groups?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

[
	{
		"id": 703,
		"name": "003",
		"notes": null,
		"organizationId": 1
	}
]

// массив объектов с информацией по группе

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Список групп ТС (без фильтрации)

Доступно только для всевидящих пользователей

GET /cars/groups/wheel

Структура запроса:

GET /cars/groups/wheel?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

[
	{
		"id": 703,
		"name": "003",
		"notes": null,
		"organizationId": 1
	}
]

// массив объектов с информацией по группе

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Редактирование группы

Доступно только для пользователей с правами администратора

PUT /cars/groups/{id}

Структура запроса:

PUT /cars/groups/4901?token=bw3ty3h46yth

{
	"id": 4901,
	"name": "name",
	"notes": "",
	"organizationId": "1143"
}

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Ответ:

Статус: 200 — успешное выполнение

{
	"id": 5000,
	"name": "name",
	"notes": "",
	"organizationId": "1143"
}

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Статус: 400 — ошибка в запросе

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Добавление группы

Доступно только для пользователей с правами администратора

POST /cars/groups

Структура запроса:

POST /cars/groups?token=bw3ty3h46yth

{
	"name": "name",
	"organizationId": "10"
}

// название группы, строка
// id организации, целое число

Ответ:

Статус: 200 — успешное выполнение

{
	"id": 4901,
	"name": "name",
	"notes": "",
	"organizationId": "1143"
}

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Статус: 400 — ошибка в запросе

Статус: 500 — ошибка на сервере

Удаление группы

Доступно только для пользователей с правами администратора

DELETE /cars/groups/{groupId}

Структура запроса:

DELETE /cars/groups/92?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Экспорт групп ТС

Доступно только для пользователей с правами администратора

GET /cars/groups.xlsx

Структура запроса:

GET/ cars/groups.xlsx?token=gtr543lpas87	

Ответ:

Статус: 200 — успешное выполнение

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Список ТС группы

GET /cars/groups/{groupId}/cars

Структура запроса:

GET /cars/groups/702/cars?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

[
	{
		"id": 4158,
		"name": "testDrivers",
		"glonassId": 354235,
		"view": true,
		"lastUpdate": null,
		"onService": false,
		"iconStandard": true,
		"iconIndex": 223,
		"toDelete": false,
		"markId": 150,
		"modelId": 1621,
		"groupId": 702,
		"speed": 0,
		"direction": 0,
		"lat": 0,
		"lon": 0,
		"carNo": "235235",
		"isStopped": false,
		"tagsIds": [ ],
		"organizationId": 1
	}
]

// массив ТС группы

// id ТС, целое число
// название, строка
// ГЛОНАСС id, целое число
// видима ли, булевое поле
// последнее обновление, timestamp
// если true - ТС на сервисном обслуживании, булевое поле
// стандартная иконка, булевое поле
// индекс иконки, целое число
// ТС в процессе удаления, булевое поле
// id марки, целое число
// id модели, целое число
// id группы, целое число
// текущая скорость, целое число
// угол, под которым вошло ТС, целое число
// широта, число с плавающей точкой
// долгота, число с плавающей точкой
// номер ТС, строка
// остановлена, булевое поле
// id меток, массив
// id организации, целое число

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Список групп машин ( с более быстрой загрузкой, т.к. без фильтрации)

GET /cars/groups/all

Структура запроса:

GET /cars/groups/all?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

[
	{
		"id": 703,
		"name": "003",
		"notes": null,
		"organizationId": 1
	}
]

// массив объектов с информацией по группе

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Количество доступных групп

GET /cars/groups/count

Структура запроса:

GET /cars/groups/count?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

{
     10
}

// количество доступных групп

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере

Все существующие группы

Доступно только для главных (всевидящих) администраторов

GET /cars/groups/wheel

Структура запроса:

GET /cars/groups/wheel?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

[
	{
		"id": 703,
		"name": "003",
		"notes": null,
		"organizationId": 1
	}
]

// массив объектов с информацией по группе

// id группы, целое число
// название группы, строка
// описание группы, строка
// id организации, целое число

Статус: 404 — объект не найден

Статус: 500 — ошибка на сервере