配件搜索 (所有可用项)
此请求为各种搜索参数（如零件号、品牌、特定车辆、产品组等）输出所有可用零件。响应包括标题、说明、零件状态、OE编号、参数、图片、PDF文档等。
请求URL
https://onedb.tecalliance.cn/api/articles
查询参数
| 名称 | 类型 | 要求 | 样例 | 描述 |
|---|---|---|---|---|
| country | String | 是 | CN | 这是基于ISO 3166的语言代码。 |
| lang | String | 是 | EN | 这是基于ISO 639的语言代码。 |
| searchQuery | String | 否 | KS01504440 | 这是一个对零件号，OE号，贸易号和EAN号的关键字搜索。 |
| articleNumber | String | 否 | 0 001 107 405 | 这只是零件号搜索。 |
| oemNumber | String | 否 | 397414F125 | 这只是OE号搜索。 |
| carId | Integer | 否 | 18358 | 这是车辆的TecDoc ktType号。 |
| linkageTargetType | Integer | 否 | 2 | 这是目标车辆类型。乘用车请用2。 |
| uid | Array | 否 | 49967076852731684497 | 如果要使用零件的唯一ID搜索一个或多个零件号，请使用此选项。 |
| dataSupplierIds | Array | 否 | 3 | 如果要筛选某些品牌的零件搜索结果，请使用此选项。 |
| productGroups | Array | 否 | 669 | 这会将零件搜索结果限制为属于该产品组的结果。 |
| assemblyGroupId | Integer | 否 | 100032 | 这将筛选展示仅属于该装配组的结果。如，仅展示100032制动盘装配组下的产品结果。 |
| includeDataSupplierFacets | Boolean | 否 | true | 这将根据搜索和筛选条件输出所有有权限的配件数据供应商列表。 |
| includeProductGroupFacets | Boolean | 否 | true | 这将根据搜索和筛选条件输出所有有权限的产品组列表。 |
| page | Integer | 否 | 1 | 将结果拆分为多页时的页码。 |
| perpage | Integer | 否 | 1 | 每页的项目数。 |
JSON输入 - 注意：此请求显示所有参数。如果你请求的话，你不会得到任何结果的。
{
"country": "CN",
"lang": "EN",
"searchQuery":"K S01 504 440",
"articleNumber": "0 001 107 405",
"oemNumber": "397414F125",
"carId": 16564,
"linkageTargetType": 2,
"uid": [
"49967076852731684497",
"53744604742035430661"
],
"dataSupplierIds": [30, 6],
"productGroups":[82],
"assemblyGroupId": 100032,
"includeDataSupplierFacets":true,
"includeProductGroupFacets":true,
"page": 1,
"perPage": 50
}
响应
一个成功的请求将会返回HTTP 200正确状态代码和如下参数的JSON响应。
| 名称 | 类型 | 样例 | 描述 |
|---|---|---|---|
| totalMatching | Integer | 3 | 已提交请求的匹配部件总数。 |
| MaxAllowedPage | Integer | 3 | 用户可以为上述特定请求访问的最大页面数。如果请求有多个项，那么maxAllowedPage号将较低。 |
| uid | Integer | 3703021090606551408 | 零件/产品的唯一ID。 |
| dataSupplierId | Integer | 6304 | TecDoc中数据供应商的ID。 |
| articleNumber | String | CU-AU042 | TecDoc中的零件号。 |
| mfrId | Integer | 5108 | TecDoc中制造商的ID。 |
| mfrName | String | QUICK BRAKE | TecDoc中的制造商名称。 |
| misc > articleStatusId | Integer | 1 | 零件状态的ID。 |
| misc > articleStatusDescription | String | Normal | 有关零件状态ID的说明。 |
| misc > articleStatusValidFromDate | Date | 20190703 | 有效状态的起始日期。 |
| misc > quantityPerPackage | Integer | 1 | 每包的数量。 |
| misc > quantityPerPartPerPackage | Integer | 1 | 每包每件的数量。 |
| misc > isSelfServicePacking | Boolean | false | |
| misc > hasMandatoryMaterialCertification | Boolean | false | |
| misc > isRemanufacturedPart | Boolean | false | |
| misc > isAccessory | Boolean | false | 零件是否为附件的通知。 |
| misc > batchSize1 | |||
| misc > batchSize2 | |||
| genericArticles > genericArticleId | Integer | 669 | 产品组ID |
| genericArticles > genericArticleDescription | String | Brake Lines Set | 产品组描述 |
| articleText | |||
| gtins | Integer | 5706021095784 | EAN代码 |
| tradeNumbers | String | - | 零件的贸易号。 |
| oemNumbers | object | - | OE号 |
| replacesArticles | Array | - | 被此零件替换的零件号。 |
| replacedByArticles | Array | - | 替换此零件的零件号。 |
| articleCriteria | Array | - | 配件参数。 |
| linkage > linkageTargetTypeId | Integer | 2 | 目标车辆类型。乘用车为2。 |
| linkage > carId | Integer | 18358 | 车辆代码（Ktype）。 |
| linkage > linkageCriteria | Object | - | 零件号适配车辆的相关参数。 |
| pdfs > url | URL | 与零件相关的PDF文档的URL。 | |
| images > url | URL | http://... | 图像路径的URL。 |
| images > type | String | JPG | 图像的类型。 |
| links > url | URL | >http://... | 指向外部链接的URL，例如Youtube视频。 |
JSON输出
{
"totalMatching": 2,
"maxAllowedPage": 1,
"articles": [
{
"uid": "53744604742035430661",
"dataSupplierId": 4617,
"articleNumber": "0 092 S37 407",
"mfrId": 3751,
"mfrName": "BOSCH",
"misc": {
"additionDescription": "S3",
"articleStatusId": 1,
"articleStatusDescription": "Normal",
"articleStatusValidFromDate": 20191027,
"quantityPerPackage": 1,
"quantityPerPartPerPackage": 0,
"isSelfServicePacking": false,
"hasMandatoryMaterialCertification": false,
"isRemanufacturedPart": false,
"isAccessory": false,
"batchSize1": null,
"batchSize2": null
},
"genericArticles": [
{
"genericArticleId": 1,
"genericArticleDescription": "Starter Battery"
},
{
"genericArticleId": 3465,
"genericArticleDescription": "Starter Battery"
}
],
"articleText": null,
"gtins": [
6949725904733,
6949725905938
],
"tradeNumbers": [
"12V, 100AH, 700A"
],
"oemNumbers": null,
"replacesArticles": null,
"replacedByArticles": null,
"mainArticle": null,
"partslist": null,
"articleCriteria": [
{
"criteriaId": 6,
"criteriaDescription": "Voltage [V]",
"criteriaType": "N",
"rawValue": "12",
"formatedVal": "12",
"immediateDisplay": true,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 68,
"criteriaDescription": "Battery Capacity [Ah]",
"criteriaType": "N",
"rawValue": "100",
"formatedVal": "100",
"immediateDisplay": true,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 64,
"criteriaDescription": "Cold-test Current, EN [A]",
"criteriaType": "N",
"rawValue": "700",
"formatedVal": "700",
"immediateDisplay": true,
"isMandatory": false,
"isInterval": false
},
{
"criteriaId": 203,
"criteriaDescription": "Length [mm]",
"criteriaType": "N",
"rawValue": "409",
"formatedVal": "409",
"immediateDisplay": true,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 206,
"criteriaDescription": "Width [mm]",
"criteriaType": "N",
"rawValue": "170",
"formatedVal": "170",
"immediateDisplay": true,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 209,
"criteriaDescription": "Height [mm]",
"criteriaType": "N",
"rawValue": "234",
"formatedVal": "234",
"immediateDisplay": true,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 77,
"criteriaDescription": "Post Positions",
"criteriaType": "A",
"rawValue": "1",
"formatedVal": "1",
"immediateDisplay": false,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 5,
"criteriaDescription": "Hold-down Type",
"criteriaType": "A",
"rawValue": "B0",
"formatedVal": "B0",
"immediateDisplay": false,
"isMandatory": true,
"isInterval": false
},
{
"criteriaId": 899,
"criteriaDescription": "Terminal Type",
"criteriaType": "A",
"rawValue": "T2",
"formatedVal": "T2",
"immediateDisplay": false,
"isMandatory": false,
"isInterval": false
}
],
"pdfs": null,
"images": null,
"links": null,
"logo": {
"url": "https://onedbcdn.tecalliance.cn/static/4617/MDAzMDAwMS5KUEc=",
"type": "JPG"
}
}
]
}