You are here: Home / 2013 / Ноябрь / 21 / Automap — rest — models

Automap — rest — models

21 ноября 2013 admin
назад
Automap / Руководство разработчика REST / Модели ТС

GET /cars/models

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


GET /cars/models?token=bw3ty3h46yth

token: ключ доступа

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


GET /cars/models?mark=1,43&expenseOn100km=12

name: типы датчиков по названию

mark: id марок (через запятую)

expenseOn100km: расход топлива на 100 км

maxTank: вместимость топливного бака

motohoursStop: коэффициент моточасов на стоянке

motohoursMove: коэффициент моточасов при движении

Ответ:

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

Формат: json

[{
		"id": 2,
		"name": "Auris",
		"expenseOn100km": 11,
		"maxTank": 100,
		"motohoursStop": null,
		"motohoursMove": null,
		"markId": 21
},...]

// id модели, целое число
// название модели, строка
// расход на 100 км, целое число
// вместимость топливного бака, целое число
// коэффициент моточасов на стоянке, целое число
// коэффициент моточасов при движении, целое число
// id марки, целое число

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

Формат: text/plain

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

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

Формат: text/plain

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

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

POST /cars/models

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


POST /cars/models?token=bw3ty3h46yth

token: ключ доступа

Формат: json

{
	"name": "Newmodel",
	"expenseOn100km": 11,
	"maxTank": 80,
	"motohoursStop": "",
	"motohoursMove": "",
	"markId": 39
}

// название модели, строка
// расход на 100 км, целое число
// вместимость топливного бака, целое число
// коэффициент моточасов на стоянке, целое число
// коэффициент моточасов при движении, целое число
// id марки, целое число

Ответ:

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

Формат: json

{
	"expenseOn100km": 11,
	"id": 1,
	"mark": {
		"id":39,
		"name": "Newmark"
	},
	"markId": 39,
	"maxTank": 80,
	"motohoursMove": 1,
	"motohoursStop": 1,
	"name": "Newmodel"
}

// расход на 100 км, целое число
// id, целое число

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

// id марки, целое число
// вместимость топливного бака, целое число
// коэффициент моточасов при движении, целое число
// коэффициент моточасов на стоянке, целое число
// название, строка

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

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

Формат: text/plain

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

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

PUT /cars/models/{id}

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


PUT /cars/models/3?token=bw3ty3h46yth

id: id модели ТС

token: ключ доступа

Формат: json

{
	"expenseOn100km": "14",
	"markId": "44",
	"maxTank": "50",
	"motohoursMove": "12",
	"motohoursStop": "4",
	"name": "GLK"
}

// расход на 100 км, целое число
// id марки, целое число
// вместимость топливного бака, целое число
// коэффициент моточасов при движении, целое число
// коэффициент моточасов на стоянке, целое число
// название, строка

Ответ:

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

Формат: json

{
	"id": 3147,
	"name": "GLK",
	"mark": {
		"id": 44,
		"name": "MERCEDES-BENZ\t"
	},
	"expenseOn100km": 14.0,
	"maxTank": 50,
	"motohoursStop": 4.0,
	"motohoursMove": 12.0,
	"markId": 44
}

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

// расход на 100 км, целое число
// вместимость топливного бака, целое число
// коэффициент моточасов при движении, целое число
// коэффициент моточасов на стоянке, целое число
// id марки, целое число

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

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

Формат: text/plain

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

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

Формат: text/plain

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

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

DELETE /cars/models/{id}

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


DELETE /cars/models/4?token=bw3ty3h46yth

id: id модели ТС

token: ключ доступа

Ответ:

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

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

Формат: text/plain

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

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

Формат: text/plain

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

GET /cars/models/count

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


GET /cars/models/count?token=bw3ty3h46yth

token: ключ доступа

Ответ:

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

Формат: text


24



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

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

Формат: text/plain

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

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

Формат: text/plain

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

GET /cars/marks/{id}/models

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


GET /cars/marks/14/models?token=bw3ty3h46yth

id: id марки

token: ключ доступа

Ответ:

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

Формат: json

[{
		"id": 15,
		"name": "21011",
		"expenseOn100km": 11,
		"maxTank": 100,
		"motohoursStop": null,
		"motohoursMove": null,
		"markId": 35
},...]

// id модели, целое число
// название модели, строка
// расход топлива на 100км, целое число
// вместимость топливного бака, целое число
// коэффициент моточасов на стоянке, целое число
// коэффициент моточасов при движении, целое число
// id марки, целое число

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

Формат: text/plain

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

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

Формат: text/plain

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

GET /cars/models.xlsx

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


GET /cars/models.xlsx?token=bw3ty3h46yth

token: ключ доступа

Ответ:

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

Формат: application/vnd.ms-excel

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

Формат: text/plain

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

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

Формат: text/plain

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

Posted in