Vignetim

Fahrzeugkategorien

Rufen Sie Fahrzeugkategorien und -typen ab, die beim Kauf von Vignetten-Tickets verwendet werden. Jedes Vignettenprodukt ist einer bestimmten Fahrzeugkategorie zugeordnet.

Fahrzeugkategorien auflisten

GET /products/vehicle-categories

Abfrageparameter

NameTypErforderlichBeschreibung
includeVehiclesbooleanNeinFahrzeugtypdetails in der Antwort einschließen (Standard: false)
languagestringNeinSprachcode für lokalisierte Namen (z. B. en, de, tr)

Antwort

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

Das Array vehicles wird nur befüllt, wenn includeVehicles=true gesetzt ist.

Fahrzeugkategorien nach Typ abrufen

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

Pfadparameter

NameTypErforderlichBeschreibung
typeIdintegerJaDie Fahrzeugtyp-ID

Antwort

Gibt Fahrzeugkategorien gefiltert nach der angegebenen Typ-ID zurück, mit derselben Antwortstruktur wie der Listenendpunkt.

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