Иконки
Список иконок
GET /cars/icons
Структура запроса:
GET /cars/icons?token=bw3ty3h46yth
token: ключ доступа
Параметры фильтрации:
GET /cars/icons?name=iconName&rotate=true
name: получение списка иконок по названию
rotate: получение списка иконок, у которых состояние поворота соответствует заданному булевому значению
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
id: 1,
name: "Автобус 3D",
width: 384,
height: 48,
initialRotation: 0,
rotate: true,
type: 1,
src0: "/cars/icons/222/0",
src1: "/cars/icons/222/1",
src2: "/cars/icons/222/2"
},...]
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Список иконок (с ускоренной загрузкой за счет отсутствия фильтрации)
GET /cars/icons/all
Структура запроса:
GET /cars/icons/all?token=bw3ty3h46yth
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: json
[{
id: 222,
name: "Автобус 3D",
width: 384,
height: 48,
initialRotation: 0,
rotate: true,
type: 1,
src0: "/cars/icons/222/0",
src1: "/cars/icons/222/1",
src2: "/cars/icons/222/2"
},...]
// id иконки, целое число
// название иконки, строка
// ширина, целое число
// высота, целое число
// первоначальный поворот, целое число
// вращается, булевое поле
// тип иконки, целое число
// иконка неактивного ТС, строка
// иконка активного ТС, строка
// иконка выделенного ТС, строка
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Получение иконки
GET /cars/icons/{id}/{type}
Структура запроса:
GET /cars/icons/24/1?token=bw3ty3h46yth
id: id иконки
type: тип иконки
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Добавление иконки ТС
Доступно только для пользователей с правами администратора
POST /cars/icons
Структура запроса:
POST /cars/icons?token=bw3ty3h46yth
Пример запроса:
{
"initialRotation": 25,
"name": "Новая иконка",
"rotate": true,
"type": 0,
"src0": "p19qst4j73p1a187q18np13tkqksn.jpg",
"src1": "p19qst4lmt1iau1g0212lf1r3icchp.jpg",
"src2": "p19qst4np91s0hcg71aoeoe7174gr.jpg"
}
// угол поворота, целое число
// название иконки, строка
// вращается, булевое поле
// тип, целое число
// иконка в неактивном состоянии, строка
// иконка в активном состоянии, строка
// иконка в выделенном состоянии, строка
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 185,
"name": "Новая иконка",
"width": 30,
"height": 22,
"initialRotation": 25,
"rotate": true,
"type": 0,
"src0": "/cars/icons/185/0",
"src1": "/cars/icons/185/1",
"src2": "/cars/icons/185/2"
}
// id иконки, целое число
// название иконки, строка
// ширина, целое число
// высота, целое число
// угол поворота, целое число
// вращается, булевое поле
// тип иконки, целое число
// иконка в неактивном состоянии, строка
// иконка в активном состоянии, строка
// иконка в выделенном состоянии, строка
Статус: 400 — ошибка в запросе
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Изменение иконки ТС
Доступно только для пользователей с правами администратора
PUT /cars/icons/{id}
Структура запроса:
PUT /cars/icons/185?token=bw3ty3h46yth
id: id иконки
token: ключ доступа
Формат: json
{
"id": 185,
"height": 22,
"initialRotation": 15,
"name": "Новое название",
"rotate": false,
"src0": null,
"src1": null,
"src2": null,
"type": 0,
"width": 30
}
// id иконки, целое число
// высота, целое число
// угол поворота, целое число
// название иконки, строка
// вращается, булевое поле
// иконка в неактивном состоянии, строка
// иконка в активном состоянии, строка
// иконка в выделенном состоянии, строка
// тип иконки, целое число
// ширина иконки, целое число
Ответ:
Статус: 200 — успешное выполнение
Формат: json
{
"id": 185,
"name": "Новое название",
"width": 30,
"height": 22,
"initialRotation": 15,
"rotate": false,
"type": 0,
"src0": "/cars/icons/185/0",
"src1": "/cars/icons/185/1",
"src2": "/cars/icons/185/2"
}
// id иконки, целое число
// название иконки, строка
// ширина, целое число
// высота, целое число
// угол поворота, целое число
// вращается, булевое поле
// тип, целое число
// src иконки в неактивном состоянии, строка
// src иконки в активном состоянии, строка
// src иконки в выделенном состоянии, строка
Статус: 400 — ошибка в запросе
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Удаление иконки
Доступно только для пользователей с правами администратора
DELETE /cars/icons/{id}
Структура запроса:
DELETE /cars/icons/24?token=bw3ty3h46yth
id: id иконки
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Количество иконок
GET /cars/icons/count
Структура запроса:
GET /cars/icons/count?token=bw3ty3h46yth
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: text
24
// Количество иконок
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Предпоказ иконки
GET /cars/icons/{id}/{status}/preview/
Структура запроса:
GET /cars/icons/31/0/preview?token=bw3ty3h46yth
id: id иконки
status: 0 — неактивное ТС; 1 — активное ТС; 2 — выделенное ТС
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: image/png
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки
Предпоказ только что загруженной иконки
GET /cars/icons/{src}/{type}/preview
Структура запроса:
GET /cars/icons/p19qst4j73p1a187q18np13tkqksn.jpg/0/preview?token=bw3ty3h46yth
src: src загруженной иконки
type: 0 — сжатая иконка; 1 — первая из восьми частей, в несжатом виде
token: ключ доступа
Ответ:
Статус: 200 — успешное выполнение
Формат: image/png
Статус: 404 — объект не найден
Формат: text/plain
Содержит описание ошибки
Статус: 500 — ошибка на сервере
Формат: text/plain
Содержит описание ошибки