Vignetim

Categorías de vehículos

Obtenga las categorías y tipos de vehículos (vehicle categories) utilizados al comprar viñetas de peaje. Cada producto de viñeta está asociado con una categoría de vehículo específica.

Listar categorías de vehículos

GET /products/vehicle-categories

Parámetros de consulta

NombreTipoRequeridoDescripción
includeVehiclesbooleanNoIncluir detalles de tipos de vehículos en la respuesta (predeterminado: false)
languagestringNoCódigo de idioma para nombres localizados (p. ej., en, de, tr)

Respuesta

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

El array vehicles solo se rellena cuando includeVehicles=true.

Obtener categorías de vehículos por tipo

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

Parámetros de ruta

NombreTipoRequeridoDescripción
typeIdintegerEl ID del tipo de vehículo

Respuesta

Devuelve las categorías de vehículos filtradas por el ID de tipo especificado, usando la misma estructura de respuesta que el endpoint de lista.

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