5105.Get Part List via VIN
Brief Summary:- Retrieve the part list for the final-level category of a specific VIN (Vehicle Identification Number) from the associated Electronic Parts Catalog (EPC).
The epc parameter must be obtained from interfaces 3001, 3002, or 3003.
last_cata_code and last_cata_code_level must be retrieved from interfaces 5101, 5102, or 5103 based on the hierarchy:
If the final-level category is primary (5101), set last_cata_code_level=1.
If the final-level category is secondary (5102), set last_cata_code_level=2.
If the final-level category is tertiary (5103), set last_cata_code_level=3.
Request URL:http://api.17vin.com:8080/{epc}?action=part&vin={vin}&last_cata_code={last_cata_code}&last_cata_code_level={last_cata_code_level}&user={username}&token={token}
- GET or POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| epc | Yes | string | Get epc from 3001 |
| vin | Yes | string | |
| action | Yes | string | part |
| last_cata_code | Yes | string | The cata_code value for the final level directory varies depending on the EPC and may be retrieved from interfaces 5101, 5102, or 5103. |
| last_cata_code_level | Yes | string | The final level directory varies depending on the EPC and may be retrieved from interfaces 5101, 5102, or 5103. |
| is_vin_filter_open | No | string | Enable VIN-based part filtering: 1 = enabled, 0 = disabled (default: 1) |
| user | Yes | string | user name |
| epc_id | No | string | |
| js_id | No | string | |
| token | Yes | string | MD5(concat(MD5(‘myusername’),MD5(‘mypassword’),’/xxx?action=part&vin=xxxxxxxxxxxxxxxxx&last_cata_code=xxxxxx&last_cata_code_level=x’)) |
{
"code": 1,
"msg": "success",
"data": {
"partlist": [{
"illustration_img_address": "090562C.png",
"callout": "09114",
"cata_code": "0901_090562C-0001",
"partnumber_original": "091140G010",
"partnumber": "091140G010",
"name_en": "SUNCONJUNTO DE EXTENSION, MANIVELA DEL GATO",
"name_zh": "千斤顶把手加长杆分总成",
"std_name_en": null,
"std_name_zh": "",
"qty": "01",
"begin_date": "201005",
"end_date": "201311",
"replacement": "",
"remark_en": "NO.2",
"remark_zh": null,
"sort": null,
"is_fit_for_this_vin": 1
},
...
{
"illustration_img_address": "090562C.png",
"callout": "81604",
"cata_code": "0901_090562C-0001",
"partnumber_original": "8160402030",
"partnumber": "8160402030",
"name_en": "JUEGO REFLECTOR, TRIANGULO",
"name_zh": "三角形反光器组件",
"std_name_en": null,
"std_name_zh": "安全警示牌",
"qty": "01",
"begin_date": "201005",
"end_date": "201311",
"replacement": "",
"remark_en": "",
"remark_zh": null,
"sort": null,
"is_fit_for_this_vin": 1
}],
"imgaddress": "090562C.png",
"all_img_hotspots": [{
"img_hotspots": {
"img_name": "090562C.png",
"img_width": 760,
"img_height": 1112,
"img_format": "image/png",
"hotspots": [{
"callout": "09114",
"topleft_x": 486,
"topleft_y": 109
}, {
"callout": "09115",
"topleft_x": 391,
"topleft_y": 64
},
...
{
"callout": "091Y9",
"topleft_x": 175,
"topleft_y": 683
}]
}
}]
}
}
Response partlist
| Parameter | Type | Description | |
|---|---|---|---|
| callout | string | ||
| qty | string | ||
| replacement | string | ||
| partnumber | string | ||
| partnumber_original | string | ||
| name_en | string | ||
| name_zh | string | ||
| std_name_en | string | ||
| std_name_zh | string | ||
| illustration_img_address | string | http://resource.17vin.com/img/{epc}/{illustration_img_address} :http://resource.17vin.com/img/toyota/090562C.png | |
| begin_date | string | ||
| end_date | string | ||
| remark_en | string | ||
| remark_zh | string | ||
| is_fit_for_this_vin | int | Applicable to current VIN: 1 = applicable, 0 = not applicable | |
| sort | int |
| Parameter | Type | Description |
|---|---|---|
| img_name | string | http://resource.17vin.com/img/{epc}/{illustration_img_address} http://resource.17vin.com/img/toyota/090562C.png |
| img_width | int | |
| img_height | string | |
| img_format | string | |
| hotspots | string | |
| hotspots>callout | string | |
| hotspots>topleft_x | string | |
| hotspots>topleft_y | string |