车型树分步搜索
此请求允许您按制造商，车型，年份和/或车辆代码调用和限制车辆结果。在请求特定制造商，车型和年份，或请求制造商，车型和车辆代码后，即可获得车辆结果。所有制造商及其车型的完整列表都在响应正文中。
请求URL
https://onedb.tecalliance.cn/api/vehicles
第一步：获取一份所有制造商，上面有车辆总数的名单。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| country | String | 是 | CN | 这是基于ISO 3166的语言代码。 |
| lang | String | 是 | EN | 这是基于ISO 639的语言代码。 |
| includeManufacturerFacet | boolean | 是 | true | 此请求将构建制造商列表。 |
JSON输入
{
"country":"CN",
"lang":"EN",
"includeManufacturerFacet": true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 260,
"data": [
{
"manuId": 3854,
"manuName": "ABARTH",
"count": 1
},
{
"manuId": 1505,
"manuName": "ACURA",
"count": 19
},
{
"manuId": 4593,
"manuName": "ACURA (GAC)",
"count": 6
},
{
"manuId": 2,
"manuName": "ALFA ROMEO",
"count": 8
},
{
"manuId": 2847,
"manuName": "ANCHI",
"count": 7
},
{
"manuId": 881,
"manuName": "ASTON MARTIN",
"count": 26
},
{
"manuId": 5,
"manuName": "AUDI",
"count": 227
},
........
........
........
........
]
},
"modelFacet": {
"total": 0,
"data": null
},
"yearFacet": null
}
第二步：获取特定制造商的所有型号的列表。这些车型将包括市场上的车辆数量。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| country | String | 是 | CN | 这是基于ISO 3166的语言代码。 |
| lang | String | 是 | EN | 这是基于ISO 639的语言代码。 |
| manuId | Integer | 是 | 5 | 这是制造商ID。 |
| includeManufacturerFacet | boolean | 否 | true | 此请求将构建制造商列表。 |
| includeModelFacet | boolean | 是 | true | 此请求将构建车型列表。 |
JSON输入
{
"country":"CN",
"lang":"EN",
"manuId": 5,
"includeManufacturerFacet": true,
"includeModelFacet":true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuId": 5,
"manuName": "AUDI",
"count": 227
}
]
},
"modelFacet": {
"total": 50,
"data": [
{
"modelId": 8604,
"modelName": "A1 (8X1, 8XK)",
"count": 2
},
{
"modelId": 9730,
"modelName": "A1 Sportback (8XA, 8XF)",
"count": 2
},
{
"modelId": 4955,
"modelName": "A3 (8P1)",
"count": 6
},
{
"modelId": 6724,
"modelName": "A3 Convertible (8P7)",
"count": 2
},
{
"modelId": 11611,
"modelName": "A3 Convertible (8V7, 8VE)",
"count": 2
},
{
"modelId": 11282,
"modelName": "A3 Limousine (8VS, 8VM)",
"count": 5
},
{
"modelId": 5143,
"modelName": "A3 Sportback (8PA)",
"count": 8
},
{
"modelId": 10459,
"modelName": "A3 Sportback (8VA, 8VF)",
"count": 3
},
{
"modelId": 4731,
"modelName": "A4 (8E2, B6)",
"count": 2
},
{
"modelId": 5376,
"modelName": "A4 (8EC, B7)",
"count": 5
},
{
"modelId": 6418,
"modelName": "A4 (8K2, B8)",
"count": 11
},
{
"modelId": 14695,
"modelName": "A4 (8W2, B9)",
"count": 1
},
{
"modelId": 8031,
"modelName": "A4 Allroad (8KH, B8)",
"count": 2
},
{
"modelId": 36378,
"modelName": "A4 Allroad (8WH, B9)",
"count": 1
},
{
"modelId": 5377,
"modelName": "A4 Avant (8ED, B7)",
"count": 3
},
{
"modelId": 6988,
"modelName": "A4 Avant (8K5, B8)",
"count": 6
},
{
"modelId": 4840,
"modelName": "A4 Convertible (8H7, B6, 8HE, B7)",
"count": 4
},
{
"modelId": 6243,
"modelName": "A5 (8T3)",
"count": 15
},
{
"modelId": 36928,
"modelName": "A5 (F53)",
"count": 3
},
{
"modelId": 8030,
"modelName": "A5 Convertible (8F7)",
"count": 12
},
{
"modelId": 37293,
"modelName": "A5 Convertible (F57)",
"count": 3
},
{
"modelId": 8159,
"modelName": "A5 Sportback (8TA)",
"count": 11
},
{
"modelId": 37116,
"modelName": "A5 Sportback (F5A)",
"count": 4
},
{
"modelId": 1891,
"modelName": "A6 (4B2, C5)",
"count": 3
},
{
"modelId": 5110,
"modelName": "A6 (4F2, C6)",
"count": 7
},
{
"modelId": 9154,
"modelName": "A6 (4G2, 4GC, C7)",
"count": 3
},
{
"modelId": 5546,
"modelName": "A6 Allroad (4FH, C6)",
"count": 1
},
{
"modelId": 10161,
"modelName": "A6 Allroad (4GH, 4GJ)",
"count": 1
},
{
"modelId": 5381,
"modelName": "A6 Avant (4F5, C6)",
"count": 1
},
{
"modelId": 9627,
"modelName": "A6 Avant (4G5, 4GD, C7)",
"count": 3
},
{
"modelId": 8986,
"modelName": "A7 Sportback (4GA, 4GF)",
"count": 12
},
{
"modelId": 265,
"modelName": "A8 (4D2, 4D8)",
"count": 1
},
{
"modelId": 4935,
"modelName": "A8 (4E2, 4E8)",
"count": 11
},
{
"modelId": 8627,
"modelName": "A8 (4H2, 4H8, 4HC, 4HL)",
"count": 11
},
{
"modelId": 38219,
"modelName": "A8 (4N2, 4N8)",
"count": 1
},
{
"modelId": 4632,
"modelName": "ALLROAD (4BH, C5)",
"count": 1
},
{
"modelId": 9731,
"modelName": "Q3 (8UB, 8UG)",
"count": 2
},
{
"modelId": 7534,
"modelName": "Q5 (8RB)",
"count": 7
},
{
"modelId": 5461,
"modelName": "Q7 (4LB)",
"count": 12
},
{
"modelId": 14159,
"modelName": "Q7 (4MB)",
"count": 3
},
{
"modelId": 6244,
"modelName": "R8 (422, 423)",
"count": 3
},
{
"modelId": 14514,
"modelName": "R8 (4S3, 4SP)",
"count": 2
},
{
"modelId": 8262,
"modelName": "R8 Spyder (427, 429)",
"count": 2
},
{
"modelId": 36765,
"modelName": "R8 Spyder (4S9, 4SR)",
"count": 1
},
{
"modelId": 5544,
"modelName": "TT (8J3)",
"count": 8
},
{
"modelId": 3851,
"modelName": "TT (8N3)",
"count": 2
},
{
"modelId": 12912,
"modelName": "TT (FV3, FVP)",
"count": 4
},
{
"modelId": 5608,
"modelName": "TT Roadster (8J9)",
"count": 7
},
{
"modelId": 4089,
"modelName": "TT Roadster (8N9)",
"count": 2
},
{
"modelId": 13274,
"modelName": "TT Roadster (FV9, FVR)",
"count": 3
}
]
},
"yearFacet": null
}
第三步：限制搜索结果以搜索特定车型的所有可用车型年款。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| country | String | 是 | CN | 这是基于ISO 3166的语言代码。 |
| lang | String | 是 | EN | 这是基于ISO 639的语言代码。 |
| manuId | Integer | 是 | 5 | 这是制造商ID。 |
| modelId | Integer | 是 | 7534 | 这是车辆制造商提供的型号ID。 |
| includeManufacturerFacet | boolean | 否 | true | 此请求将构建制造商列表。 |
| includeModelFacet | boolean | 是 | true | 此请求将构建车型列表。 |
| includeYearfacet | boolean | 是 | true | 此参数将为所选模型生成所有可用年份。 |
JSON输入
{
"country":"CN",
"lang":"EN",
"manuId": 5,
"modelId": 7534,
"includeManufacturerFacet": true,
"includeModelFacet":true,
"includeYearfacet":true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuId": 5,
"manuName": "AUDI",
"count": 7
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelId": 7534,
"modelName": "Q5 (8RB)",
"count": 7
}
]
},
"yearFacet": [
{
"count": 6,
"year": 2020
},
{
"count": 6,
"year": 2019
},
{
"count": 6,
"year": 2018
},
{
"count": 6,
"year": 2017
},
{
"count": 7,
"year": 2016
},
{
"count": 7,
"year": 2015
},
{
"count": 6,
"year": 2014
},
{
"count": 6,
"year": 2013
},
{
"count": 4,
"year": 2012
},
{
"count": 3,
"year": 2011
},
{
"count": 3,
"year": 2010
},
{
"count": 3,
"year": 2009
},
{
"count": 2,
"year": 2008
}
]
}
第四步：获取制造商>车型>年份组合的所有可用车辆。可以通过多次请求来获取车辆。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| country | String | 是 | CN | 这是基于ISO 3166的语言代码。 |
| lang | String | 是 | EN | 这是基于ISO 639的语言代码。 |
| manuId | Integer | 是 | 5 | 这是制造商ID。 |
| modelId | Integer | 是 | 7534 | 这是车辆制造商提供的型号ID。 |
| year | Integer | 是 | 2015 | 今年是车型年份。 |
| includeManufacturerFacet | boolean | 否 | true | 此请求将构建制造商列表。 |
| includeModelFacet | boolean | 是 | true | 此请求将构建车型列表。 |
| includeYearfacet | boolean | 是 | true | 此参数将为所选模型生成所有可用年份。 |
JSON输入
{
"country":"CN",
"lang":"EN",
"manuId": 5,
"modelId": 7534,
"year":2015,
"includeManufacturerFacet": true,
"includeModelFacet":true,
"includeYearfacet":true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 7,
"maxAllowedPage": 1,
"vehicles": [
{
"carId": 27563,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 211,
"powerKwTo": 155,
"typeName": "2.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "200811",
"yearOfConstrTo": "",
"engineCode": [
"CDNC",
"CAEB",
"CPMA"
]
},
{
"carId": 30740,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 6,
"cylinderCapacityCcm": 3197,
"cylinderCapacityLiter": 320,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 270,
"powerKwTo": 199,
"typeName": "3.2 FSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "FSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "200811",
"yearOfConstrTo": "",
"engineCode": [
"CALB"
]
},
{
"carId": 31955,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 180,
"powerKwTo": 132,
"typeName": "2.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "200908",
"yearOfConstrTo": "",
"engineCode": [
"CDNB",
"CNCB"
]
},
{
"carId": 56113,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 6,
"cylinderCapacityCcm": 2995,
"cylinderCapacityLiter": 300,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 272,
"powerKwTo": 200,
"typeName": "3.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201301",
"yearOfConstrTo": "",
"engineCode": [
"CTUC",
"CTVA"
]
},
{
"carId": 56939,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol/Electro",
"engineType": "Hybrid",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 245,
"powerKwTo": 180,
"typeName": "2.0 40 Hybrid quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "40 Hybrid ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201209",
"yearOfConstrTo": "201605",
"engineCode": null
},
{
"carId": 100066,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 6,
"cylinderCapacityCcm": 2995,
"cylinderCapacityLiter": 300,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 354,
"powerKwTo": 260,
"typeName": "SQ5 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "SQ5 TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201305",
"yearOfConstrTo": "",
"engineCode": [
"CTUD",
"CTXA"
]
},
{
"carId": 116058,
"manuId": 5,
"manuName": "AUDI",
"modId": 7534,
"modelName": "Q5 (8RB)",
"constructionType": "Closed Off-Road Vehicle",
"cylinder": 4,
"cylinderCapacityCcm": 1984,
"cylinderCapacityLiter": 200,
"fuelType": "Petrol",
"engineType": "Petrol Engine",
"fuelTypeProcess": "Direct Injection",
"impulsionType": "All-wheel Drive",
"powerHpTo": 230,
"powerKwTo": 169,
"typeName": "2.0 TFSI quattro",
"valves": 4,
"modelGeneration": "",
"structureSynonym": "",
"salesDesignation": "Q5 (2008-)",
"modelDesign": "8RB",
"typeDesign": "",
"typeDesignation": "TFSI ",
"driveSystemSynonym": "quattro",
"yearOfConstrFrom": "201508",
"yearOfConstrTo": "",
"engineCode": [
"CNCE"
]
}
],
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuId": 5,
"manuName": "AUDI",
"count": 7
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelId": 7534,
"modelName": "Q5 (8RB)",
"count": 7
}
]
},
"yearFacet": [
{
"count": 6,
"year": 2020
},
{
"count": 6,
"year": 2019
},
{
"count": 6,
"year": 2018
},
{
"count": 6,
"year": 2017
},
{
"count": 7,
"year": 2016
},
{
"count": 7,
"year": 2015
},
{
"count": 6,
"year": 2014
},
{
"count": 6,
"year": 2013
},
{
"count": 4,
"year": 2012
},
{
"count": 3,
"year": 2011
},
{
"count": 3,
"year": 2010
},
{
"count": 3,
"year": 2009
},
{
"count": 2,
"year": 2008
}
]
}