AmPart Search (all options)
This request outputs all available parts for various search parameter like part numbers, brands, specific vehicles, productgroup etc. The response includes title, description, part status, OE number, criteria, images, PDF documents etc. You will need a token to access this service. If you don't have a token, then please contact your TecAlliance support.
Query URL
https://onedb.tecalliance.cn/api/chinaid/articles
Query parameter
| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| lang | String | Yes | EN | This is the language code according to ISO 639. |
| searchQuery | String | No | KS01504440 | This is a keyword search accross part number, OE number, trade number and EAN number. |
| articleNumber | String | No | 0 001 107 405 | This is a part number search only. |
| shortId | String | No | AA02001643B0002 | This is the shortId of a vehicle. |
| uid | Array | No | 49967076852731684497 | Use this if you want to search for one or multiple part number using their unique ID. |
| dataSupplierIds | Array | No | 3 | Use this if you want to filter part search results for some brands. |
| productGroups | Array | No | 669 | This will limit the part search results to the product groups added. |
| assemblyGroupId | Integer | No | 100032 | This will filter the results for a specific assembly group, e.g. 100032 for brake discs. |
| includeDataSupplierFacets | Boolean | No | true | This will output a facet with all data supplier based on the search and filter condition. |
| includeProductGroupFacets | Boolean | No | true | This will output a facet with all product groups based on the search and filter condition. |
| page | Integer | No | 1 | Page number when the results are split to several pages. |
| perpage | Integer | No | 1 | Number of items per page. |
JSON Input - Note: This request shows all parameter. You won't get any result if you request it.
{
"lang": "EN",
"searchQuery":"K S01 504 440",
"articleNumber": "0 001 107 405",
"shortId": "AA02001643B0002",
"uid": [
"49967076852731684497",
"53744604742035430661"
],
"dataSupplierIds": [30, 6],
"productGroups":[82],
"assemblyGroupId": 100032,
"includeDataSupplierFacets":true,
"includeProductGroupFacets":true,
"page": 1,
"perPage": 50
}
RESPONSE
A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.
| Name | Type | Example | Description |
|---|---|---|---|
| totalMatching | Integer | 3 | The total number of matching parts for the submitted request. |
| MaxAllowedPage | Integer | 3 | The max number of page the user can visit for the specific request above. If the request has more than one item, then the maxAllowedPage number will be lower. |
| uid | Integer | 3703021090606551408 | Unique ID of the part/article. |
| dataSupplierId | Integer | 6304 | The ID of the data supplier in TecDoc. |
| articleNumber | String | CU-AU042 | The part number in TecDoc. |
| mfrId | Integer | 5108 | The ID of the manufacturer in TecDoc. |
| mfrName | String | QUICK BRAKE | The name of the manufacturer in TecDoc. |
| misc > articleStatusId | Integer | 1 | The ID of the part status. |
| misc > articleStatusDescription | String | Normal | The description regarding the ID of the part status. |
| misc > articleStatusValidFromDate | Date | 20190703 | The date from which the status is valid. |
| misc > quantityPerPackage | Integer | 1 | The quantity per package. |
| misc > quantityPerPartPerPackage | Integer | 1 | The quantity per part per package. |
| misc > isSelfServicePacking | Boolean | false | |
| misc > hasMandatoryMaterialCertification | Boolean | false | |
| misc > isRemanufacturedPart | Boolean | false | |
| misc > isAccessory | Boolean | false | A notice whether the part is an accessory. |
| misc > batchSize1 | |||
| misc > batchSize2 | |||
| genericArticles > genericArticleId | Integer | 669 | Product group ID |
| genericArticles > genericArticleDescription | String | Brake Lines Set | Product group description |
| articleText | |||
| gtins | Integer | 5706021095784 | EAN number |
| tradeNumbers | String | - | The trade number of the part. |
| oemNumbers | object | - | OE number |
| replacesArticles | Array | - | The part number which got replaced by this part. |
| replacedByArticles | Array | - | The part number which replaces this part. |
| articleCriteria | Array | - | Part number criteria. |
| pdfs > url | URL | An URL to a PDF document related the part. | |
| images > url | URL | http://... | The URL to an image path. |
| images > type | String | JPG | The type of image. |
| links > url | URL | >http://... | The URL to an external link, e.g. Youtube video. |
JSON Output
{
"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"
}
}
]
}