AmPart Search (Based on KType)

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 ktype.

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 KType 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 KType 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": ""
        }
    ]
}