Create a single view app that requests data from a rest-api and display that data in the app for an american customer.
Get the vehicle attributes for a given car
URI parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
| vin | The vin to find. | string | Yes |
Response
HTTP 200 OK with the vehihle-attributes document
| Parameter | Description | Type | Restriction | Required |
|---|---|---|---|---|
| regno | Registration number | string | Alphanumeric, 6-7 characters | Yes |
| vin | The vin number | string | Yes | |
| brand | The brand of the vehicle | string | possible values are volvo, ford, saab, rover |
Yes |
| year | The model year | number | Yes | |
| gearbox_type | The type of gearbox | string | possible values are manual, automatic |
Yes |
| fuel_types | Possible fueltypes in order of importance. At least one is provided | array of strings | possible values are gasoline, diesel |
Yes |
| fuel | Fuel information | Yes | ||
| fuel.gasoline | Provided if the car is a gasoline car | No | ||
| fuel.gasoline.average_consumption | Average consumption | Yes | ||
| fuel.gasoline.average_consumption.mixed | Average consumption for mixed driving | number | unit is liters/meter |
No |
| fuel.gasoline.average_consumption.rural | Average consumption for rural driving | number | unit is liters/meter |
No |
| fuel.gasoline.average_consumption.urban | Average consumption for urban driving | number | unit is liters/meter |
No |
| fuel.gasoline.tank_volume | The volume of the fuel tank | number | unit is liters |
Yes |
| fuel.diesel | Provided if the car is a diesel car | No | ||
| fuel.diesel.average_consumption | Average consumption | Yes | ||
| fuel.diesel.average_consumption.mixed | Average consumption for mixed driving | number | unit is liters/meter |
No |
| fuel.diesel.average_consumption.rural | Average consumption for rural driving | number | unit is liters/meter |
No |
| fuel.diesel.average_consumption.urban | Average consumption for urban driving | number | unit is liters/meter |
No |
| fuel.diesel.tank_volume | The volume of the fuel tank | number | unit is liters |
Yes |
| emission | Emission information | Yes | ||
| emission.gasoline | Provided if the car is a gasoline car | No | ||
| emission.gasoline.co2 | Average emissions | Yes | ||
| emission.gasoline.co2.mixed | Average emissions for mixed driving | number | unit is kilograms/meter |
No |
| emission.gasoline.co2.rural | Average emissions for rural driving | number | unit is kilograms/meter |
No |
| emission.gasoline.co2.urban | Average emissions for urban driving | number | unit is kilograms/meter |
No |
| emission.diesel | Provided if the car is a diesel car | No | ||
| emission.diesel.co2 | Average emissions | Yes | ||
| emission.diesel.co2.mixed | Average emissions for mixed driving | number | unit is kilograms/meter |
No |
| emission.diesel.co2.rural | Average emissions for rural driving | number | unit is kilograms/meter |
No |
| emission.diesel.co2.urban | Average emissions for urban driving | number | unit is kilograms/meter |
No |
| timestamp | The time of last update | date | iso-8601 format in UTC |
Yes |
Example:
{
"regno": "wur816",
"vin": "tmbga61z852094863",
"timestamp": "2015-05-29T12:18:31.390Z",
"emission": {
"gasoline": {
"co2": {
"mixed": 0.000175
}
}
},
"fuel": {
"gasoline": {
"average_consumption": {
"urban": 0.000099,
"rural": 0.000058,
"mixed": 0.000073
}
}
},
"gearbox_type": "manual",
"year": 2005,
"brand": "volvo",
"fuel_types": [
"gasoline"
]
}