Automap — rest —Tags

Метки

Список меток

GET /cars/tags

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

GET /cars/tags?token=bw3ty3h46yth

Параметры фильтрации

Ответ:

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

[{
		"id": 1,
		"name": "Название метки",
		"color": "ff0000"
},...]

// id метки, целое число
// название метки, строка
// цвет метки, строка

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

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

Создание метки

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

POST /cars/tags

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

POST /cars/tags?token=bw3ty3h46yth

{
	"color": "ffb833",
	"name": "Метка" 
}

// цвет метки, строка
// название метки, строка

Ответ:

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

{
	"id": 128,
	"color": "ffb833",
	"name": "Метка" 
}

// id метки, целое число
// цвет метки, строка
// название метки, строка

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

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

Получение метки по id

GET /cars/tags/{id}

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

GET /cars/tags/15?token=bw3ty3h46yth

Ответ:

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

{
		"id": 15,
		"name": "Название метки",
		"color": "ff0000"
}

// id метки, целое число
// название метки, строка
// цвет метки, строка

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

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

Редактирование метки

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

PUT /cars/tags/{id}

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

PUT /cars/tags/15?token=bw3ty3h46yth

{
		"id": 15,
		"name": "Название метки",
		"color": "ff0000"
}

// id метки, целое число
// название метки, строка
// цвет метки, строка

Ответ:

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

{
		"id": 15,
		"name": "Название метки",
		"color": "ff0000"
}

// id метки, целое число
// название метки, строка
// цвет метки, строка

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

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

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

Удаление метки

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

DELETE /cars/tags/{id}

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

DELETE /cars/tags/6?token=bw3ty3h46yth 

Ответ:

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

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

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

Количество меток

GET /cars/tags/count

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

GET /cars/tags/count?token=bw3ty3h46yth

Ответ:

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

107

// количество меток

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

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