Vignetim

Kategorie vozidel (Vehicle Categories)

Získejte kategorie a typy vozidel používané při nákupu dálničních známek. Každý produkt dálniční známky je přiřazen ke konkrétní kategorii vozidla.

Výpis kategorií vozidel

GET /products/vehicle-categories

Parametry dotazu

NázevTypPovinnýPopis
includeVehiclesbooleanNeZahrnout podrobnosti o typech vozidel v odpovědi (výchozí: false)
languagestringNeKód jazyka pro lokalizované názvy (např. en, de, tr)

Odpověď

{
	"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": []
		}
	]
}

Pole vehicles je vyplněno pouze tehdy, když includeVehicles=true.

Získání kategorií vozidel podle typu

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

Parametry cesty

NázevTypPovinnýPopis
typeIdintegerAnoID typu vozidla

Odpověď

Vrací kategorie vozidel filtrované podle zadaného ID typu se stejnou strukturou odpovědi jako endpoint pro výpis.

{
	"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": []
		}
	]
}