车型树分步搜索
此请求允许您按制造商，车型，年份和/或销售款型调用和限制车辆结果。在请求特定制造商，车型和年份，或请求制造商，车型和销售款型后，即可获得车辆结果。所有制造商及其车型的完整列表都在响应正文中。
请求URL
https://onedb.tecalliance.cn/api/vehicles/chinaid
第一步：获取一份所有制造商，上面有车辆总数的名单。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| includeManufacturerFacet | boolean | 是 | true | 此请求将构建制造商列表。 |
JSON 输入
{
"includeManufacturerFacet": true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 219,
"data": [
{
"manuName": "Alpina",
"total": 3
},
{
"manuName": "Fisker",
"total": 2
},
{
"manuName": "GMC",
"total": 203
},
{
"manuName": "Jeep(进口)",
"total": 523
},
{
"manuName": "KTM",
"total": 2
},
{
"manuName": "MINI",
"total": 500
},
{
"manuName": "Smart",
"total": 250
},
......
......
......
......
]
},
"modelFacet": {
"total": 0,
"data": null
},
"yearFacet": null,
"salesNameFacet": {
"total": 0,
"data": null
}
}
第二步：获取特定制造商的所有型号的列表。这些车型将包括市场上的车辆数量。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| manuName | String | 是 | MINI | 这是上述响应里的制造商的名称。 |
| includeManufacturerFacet | boolean | 否 | true | 此请求将构建制造商列表。 |
| includeModelFacet | boolean | 是 | true | 此请求将构建车型列表。 |
JSON输入
{
"manuName": "MINI",
"includeManufacturerFacet": true,
"includeModelFacet": true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuName": "MINI",
"total": 500
}
]
},
"modelFacet": {
"total": 8,
"data": [
{
"modelName": "Cabrio",
"total": 54
},
{
"modelName": "Clubman",
"total": 94
},
{
"modelName": "Countryman",
"total": 105
},
{
"modelName": "Coupe",
"total": 15
},
{
"modelName": "Mini",
"total": 159
},
{
"modelName": "Mini 5-Door",
"total": 52
},
{
"modelName": "Paceman",
"total": 16
},
{
"modelName": "Roadster",
"total": 5
}
]
},
"yearFacet": null,
"salesNameFacet": {
"total": 0,
"data": null
}
}
第三步：搜索特定车型的所有可用车型年款和销售款型定义，限制搜索结果。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| manuName | String | 是 | MINI | 这是上述响应里的制造商的名称。 |
| modelName | String | 是 | Countryman | 这是第二步响应里的车型名称。 |
| includeManufacturerFacet | boolean | 否 | true | 此请求将构建制造商列表。 |
| includeModelFacet | boolean | 否 | true | 此请求将构建车型列表。 |
| includeYearFacet | boolean | 否，如果已使用ncludeSalesNameFacet。 | true | 此请求将构建车型年份列表。 |
| includeSalesNameFacet | boolean | 否，如果已使用includeYearFacet。 | true | 此请求将构建销售款型列表。 |
JSON输入
{
"manuName": "MINI",
"modelName": "Countryman",
"includeManufacturerFacet": true,
"includeModelFacet": true,
"includeYearFacet": true,
"includeSalesNameFacet": true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 0,
"maxAllowedPage": 0,
"vehicles": null,
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuName": "MINI",
"total": 105
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelName": "Countryman",
"total": 105
}
]
},
"yearFacet": [
{
"count": 3,
"year": 2010
},
{
"count": 4,
"year": 2015
},
{
"count": 2,
"year": 2012
},
{
"count": 18,
"year": 2016
},
{
"count": 8,
"year": 2013
},
{
"count": 10,
"year": 2011
},
{
"count": 16,
"year": 2014
},
{
"count": 26,
"year": 2017
},
{
"count": 18,
"year": 2018
}
],
"salesNameFacet": {
"total": 33,
"data": [
{
"salesName": "1.5T 手自一体",
"total": 4
},
{
"salesName": "1.5T 手自一体 探险家",
"total": 4
},
{
"salesName": "1.5T 手自一体 旅行家",
"total": 2
},
{
"salesName": "1.5T 手自一体 特别版",
"total": 2
},
{
"salesName": "1.5T 手自一体 经典派",
"total": 4
},
{
"salesName": "1.5T 手自一体 艺术家",
"total": 4
},
{
"salesName": "1.5T 手自一体 赛车手",
"total": 2
},
{
"salesName": "1.5T 手自一体 非常假日版 英伦绿",
"total": 2
},
{
"salesName": "1.5T 手自一体 非常假日版 辣椒红",
"total": 2
},
{
"salesName": "1.6L 手自一体",
"total": 8
},
{
"salesName": "1.6L 手自一体 Excitement",
"total": 2
},
{
"salesName": "1.6L 手自一体 Excitement ",
"total": 2
},
{
"salesName": "1.6L 手自一体 Fun",
"total": 4
},
{
"salesName": "1.6L 手自一体 Fun ",
"total": 2
},
{
"salesName": "1.6T 手动",
"total": 1
},
{
"salesName": "1.6T 手动 柴油版",
"total": 1
},
{
"salesName": "1.6T 手自一体",
"total": 17
},
{
"salesName": "1.6T 手自一体 Excitement",
"total": 4
},
{
"salesName": "1.6T 手自一体 Excitement 装备控",
"total": 2
},
{
"salesName": "1.6T 手自一体 Fun",
"total": 4
},
{
"salesName": "1.6T 手自一体 Fun 装备控",
"total": 2
},
{
"salesName": "1.6T 手自一体 Park Lane",
"total": 4
},
{
"salesName": "1.6T 手自一体 极致暗夜版",
"total": 2
},
{
"salesName": "1.6T 手自一体 滑雪板",
"total": 2
},
{
"salesName": "1.6T 手自一体 装备控",
"total": 2
},
{
"salesName": "1.6T 手自一体 进藏限量版",
"total": 2
},
{
"salesName": "2.0T 手自一体",
"total": 4
},
{
"salesName": "2.0T 手自一体 探险家",
"total": 2
},
{
"salesName": "2.0T 手自一体 旅行家",
"total": 4
},
{
"salesName": "2.0T 手自一体 经典派",
"total": 2
},
{
"salesName": "2.0T 手自一体 艺术家",
"total": 2
},
{
"salesName": "2.0T 手自一体 赛车手",
"total": 2
},
{
"salesName": "2.0T 手自一体 赛车控",
"total": 2
}
]
}
}
第四步：获取制造商>车型>年份或制造商>车型>销售名称组合的所有可用车辆。可以通过多次请求来获取车辆。
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| manuName | String | 是 | MINI | 这是制造商的名称。 |
| modelName | String | 是 | Countryman | 这是车型名称。 |
| year | Integer | 否，如果已加入salesname。 | 2014 | 这是前一步响应里的车型年份。 |
| salesName | String | 否，如果已加入year。 | 1.6L 手自一体 Excitement | 这是前一步响应里的salesName。 |
| includeManufacturerFacet | boolean | 否 | true | 此请求将构建制造商列表。 |
| includeModelFacet | boolean | 否 | true | 此请求将构建车型列表。 |
| includeYearFacet | boolean | 否 | true | 此请求将构建车型年份列表。 |
| includeSalesNameFacet | boolean | 否 | true | 此请求将构建销售款型列表。 |
| perpage | Integer | 否 | 50 | 每次请求的响应里的车辆数。 |
| page | Integer | 否 | 1 | 查看如果总数大于每页的车辆数的页面。 |
JSON输入
{
"manuName": "MINI",
"modelName": "Countryman",
"year": 2014,
"page": 1,
"perpage": 10,
"includeManufacturerFacet": true,
"includeModelFacet": true,
"includeYearFacet": true,
"includeSalesNameFacet": true
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
{
"totalMatching": 16,
"maxAllowedPage": 2,
"vehicles": [
{
"shortId": "MM05003116D0003",
"modelId": "MM05003116D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 105656,
"tecId": "TEC000670",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman",
"salesName": "1.6L 手自一体 Excitement",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N16B16A",
"capacityLitre": "1.6 L",
"charging": "自然吸气",
"maximumOutputPs": "120",
"maximumOutputKw": "88",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "多点电喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05003116D0004",
"modelId": "MM05003116D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 105656,
"tecId": "TEC000694",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman",
"salesName": "1.6L 手自一体 Fun",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N16B16A",
"capacityLitre": "1.6 L",
"charging": "自然吸气",
"maximumOutputPs": "120",
"maximumOutputKw": "88",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "多点电喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05003016D0005",
"modelId": "MM05003016D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 108611,
"tecId": "TEC000677",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman All 4",
"salesName": "1.6T 手自一体 Excitement",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "122",
"maximumOutputKw": "90",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05003016D0004",
"modelId": "MM05003016D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 108611,
"tecId": "TEC000698",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper Countryman All 4",
"salesName": "1.6T 手自一体 Fun",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "122",
"maximumOutputKw": "90",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "205/55 R17",
"rearTyreSpecification": "205/55 R17",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002716D0002",
"modelId": "MM05002716D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 56172,
"tecId": "TEC000640",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "JCW Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N18B16C",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "218",
"maximumOutputKw": "160",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002916D0002",
"modelId": "MM05002916D",
"chinaIdStatus": "",
"oversea": "",
"ktype": null,
"tecId": "TEC000666",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper S Countryman",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "190",
"maximumOutputKw": "140",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002816D0008",
"modelId": "MM05002816D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 106283,
"tecId": "TEC000639",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper S Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "190",
"maximumOutputKw": "140",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002616D0002",
"modelId": "MM05002616D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 34921,
"tecId": "TEC000676",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "One Countryman",
"salesName": "1.6L 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N16B16A",
"capacityLitre": "1.6 L",
"charging": "自然吸气",
"maximumOutputPs": "98",
"maximumOutputKw": "72",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "多点电喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "前轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "195/55 R16",
"rearTyreSpecification": "195/55 R16",
"spareTyreStandard": "",
"source": "import"
},
{
"shortId": "MM05002816D0008",
"modelId": "MM05002816D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 106283,
"tecId": "TEC000639",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "Cooper S Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2016,
"engineCode": "N18B16A",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "190",
"maximumOutputKw": "140",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "standard"
},
{
"shortId": "MM05002716D0002",
"modelId": "MM05002716D",
"chinaIdStatus": "",
"oversea": "",
"ktype": 56172,
"tecId": "TEC000640",
"brand": "MINI",
"manufacturer": "MINI",
"model": "Countryman",
"modelType": "JCW Countryman All 4",
"salesName": "1.6T 手自一体",
"modelDesign": "R60",
"modelYear": 2014,
"vehicleType": "SUV",
"vehicleLevel": "",
"listingYear": 2014,
"discountinuationYear": 2017,
"engineCode": "N18B16C",
"capacityLitre": "1.6 T",
"charging": "涡轮增压",
"maximumOutputPs": "218",
"maximumOutputKw": "160",
"cylinderCount": 4,
"valveCountPerCylinder": 4,
"fuelType": "汽油",
"mixturePreperation": "直喷",
"transmissionType": "自动",
"transmissionDescription": "手自一体变速器(AMT)",
"driveSystem": "四轮驱动",
"frontBrakeType": "盘式",
"rearBrakeType": "盘式",
"boxDesign": "两厢",
"doorCount": 5,
"seatCount": "5",
"frontTyreSpecification": "225/45 R18",
"rearTyreSpecification": "225/45 R18",
"spareTyreStandard": "",
"source": "standard"
}
],
"manufacturerFacet": {
"total": 1,
"data": [
{
"manuName": "MINI",
"total": 16
}
]
},
"modelFacet": {
"total": 1,
"data": [
{
"modelName": "Countryman",
"total": 16
}
]
},
"yearFacet": [
{
"count": 16,
"year": 2014
}
],
"salesNameFacet": {
"total": 6,
"data": [
{
"salesName": "1.6L 手自一体",
"total": 2
},
{
"salesName": "1.6L 手自一体 Excitement",
"total": 2
},
{
"salesName": "1.6L 手自一体 Fun",
"total": 2
},
{
"salesName": "1.6T 手自一体",
"total": 6
},
{
"salesName": "1.6T 手自一体 Excitement",
"total": 2
},
{
"salesName": "1.6T 手自一体 Fun",
"total": 2
}
]
}
}