AmPart Search (based on ChinaID)

Use part number search to get all available parts for a specific shortId or ktype in the market. Part number search will return all available product groups for a requested shortId or kType. You have to select a product group in order to get all parts for that combination.

Query URL

https://onedb.tecalliance.cn/api/articles/chinaid

Step 1: Fetch all available product groups for that specific ChinaID (shortId).

Query parameter

Name Type Required Example Description
shortId String shortId or ktype is required BH01004116D0005 This is the shortId of a vehicle.
ktype Integer shortId or ktype is required 100350 This is the TecDoc kType number of vehicle.
lang String Yes EN This is the language code of the response.
perpage Integer No 50 The number of vehicles in the response body per request.
page Integer No 1 The page to visit if the total number is larger than the number of vehicles per page.

JSON Input

{
   "shortId": "BH01004116D0005",
   "lang": "EN"
}
                

RESPONSE

A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.

Name Type Example Description
totalMatching Integer 4 The total number of matching vehicles for the submitted request.
MaxAllowedPage Integer 1 The max number of page the user can visit when requested vehicles for a specific page.
productGroupID Integer 1667 This is the product group ID.
productGroupName String Transmission Oil This is the name of the product group
count Integer 1 These are the number of parts within that product group.

JSON Output

{
    "totalMatching": 4,
    "maxAllowedPage": 1,
    "data": [
        {
            "productGroupID": 1667,
            "productGroupName": "Transmission Oil",
            "count": 1
        },
        {
            "productGroupID": 3224,
            "productGroupName": "Engine Oil",
            "count": 1
        },
        {
            "productGroupID": 686,
            "productGroupName": "Spark Plug",
            "count": 1
        },
        {
            "productGroupID": 7,
            "productGroupName": "Oil Filter",
            "count": 3
        }
    ]
}
                



Step 2: Fetch all available brands for that specific ChinaID (shortId) plus product group combination.

Query parameter

Name Type Required Example Description
shortId String shortId or ktype is required BH01004116D0005 This is the shortId of a vehicle.
ktype Integer shortId or ktype is required 100350 This is the TecDoc kType number of vehicle.
productGroupId String Yes 7 This is the product group ID
lang String Yes EN This is the language code of the response.
perpage Integer No 50 The number of vehicles in the response body per request.
page Integer No 1 The page to visit if the total number is larger than the number of vehicles per page.

JSON Input

{
   "shortId": "BH01004116D0005",
   "productGroupId": 7,
   "lang": "EN"
}
                

RESPONSE

A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.

Name Type Example Description
totalMatching Integer 4 The total number of matching vehicles for the submitted request.
MaxAllowedPage Integer 1 The max number of page the user can visit when requested vehicles for a specific page.
brandName String Bosch This is the name of the automotive aftermarket parts manufacturer.
count Integer 1 These are the number of items for that specific search request.

JSON Output

{
    "totalMatching": 3,
    "maxAllowedPage": 1,
    "data": [
        {
            "brandName": "BaoWang",
            "count": 1
        },
        {
            "brandName": "Hengst",
            "count": 1
        },
        {
            "brandName": "Bosch",
            "count": 1
        }
    ]
}
                



Step 3: Fetch all available parts for that specific ChinaID (shortId) plus product group and brand name combination.

Query parameter

Name Type Required Example Description
shortId String shortId or ktype is required BH01004116D0005 This is the shortId of a vehicle.
ktype Integer shortId or ktype is required 100350 This is the TecDoc kType number of vehicle.
productGroupId Integer Yes 7 This is the product group ID
brandName String Yes Bosch This is the name of the automotive aftermarket parts manufacturer.
lang String Yes EN This is the language code of the response.
perpage Integer No 50 The number of vehicles in the response body per request.
page Integer No 1 The page to visit if the total number is larger than the number of vehicles per page.

JSON Input

{
   "shortId": "BH01004116D0005",
   "productGroupId": 7,
   "brandName": "Bosch",
   "lang": "EN"
}
                

RESPONSE

A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.

Name Type Example Description
totalMatching Integer 4 The total number of matching vehicles for the submitted request.
MaxAllowedPage Integer 1 The max number of page the user can visit when requested vehicles for a specific page.
productGroupID Integer 1667 This is the product group ID.
productGroupName String Transmission Oil This is the name of the product group
shortId String BH01004116D0005 This is the shortId of a vehicle.
ktype Integer 100350 This is the TecDoc kType number of vehicle.
partNumber String F026407173 This is the part number
brandName String Bosch Brand name associated with the part.
oeNumber String 11427635557 This is the OE number associacted with the part.
remark String Additional notes on part or brand level.

JSON Output

{
    "totalMatching": 1,
    "maxAllowedPage": 1,
    "productGroupId": 7,
    "productGroupName": "Oil Filter",
    "data": [
        {
            "shortId": "BH01004116D0005",
            "ktype": 100350,
            "partNumber": "F026407173",
            "brandName": "Bosch",
            "oeNumber": [
                "11427635557",
                "11427611969"
            ],
            "remark": ""
        }
    ]
}