Vignetim

Категории транспорта (Vehicle Categories)

Получайте категории и типы транспортных средств, используемые при покупке виньеток. Каждый продукт виньетки связан с определённой категорией транспортного средства.

Список категорий транспорта

GET /products/vehicle-categories

Параметры запроса

ИмяТипОбязательныйОписание
includeVehiclesbooleanНетВключить детали типов транспортных средств в ответ (по умолчанию: false)
languagestringНетКод языка для локализованных названий (например, en, de, tr)

Ответ

{
	"data": [
		{
			"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"name": "Car (up to 3.5t)",
			"description": "Passenger vehicles and motorhomes up to 3.5 tonnes",
			"typeId": 1,
			"vehicles": [
				{
					"id": "a1b2c3d4-0000-1111-2222-333344445555",
					"name": "Sedan",
					"icon": "car-sedan"
				},
				{
					"id": "a1b2c3d4-0000-1111-2222-333344446666",
					"name": "SUV",
					"icon": "car-suv"
				}
			]
		},
		{
			"id": "f2e3d4c5-b6a7-8901-bcde-f12345678901",
			"name": "Motorcycle",
			"description": "Two-wheeled motor vehicles",
			"typeId": 2,
			"vehicles": []
		},
		{
			"id": "f3e4d5c6-b7a8-9012-cdef-123456789012",
			"name": "Trailer (up to 3.5t)",
			"description": "Trailers with a maximum weight of 3.5 tonnes",
			"typeId": 3,
			"vehicles": []
		}
	]
}

Массив vehicles заполняется только при includeVehicles=true.

Получить категории транспорта по типу

GET /products/vehicle-categories/by-type/:typeId

Параметры пути

ИмяТипОбязательныйОписание
typeIdintegerДаID типа транспортного средства

Ответ

Возвращает категории транспортных средств, отфильтрованные по указанному ID типа, с той же структурой ответа, что и у эндпоинта списка.

{
	"data": [
		{
			"id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
			"name": "Car (up to 3.5t)",
			"description": "Passenger vehicles and motorhomes up to 3.5 tonnes",
			"typeId": 1,
			"vehicles": []
		}
	]
}