5101.Get Primary Category List via VIN
Brief Summary:- Retrieve the primary category list (first-level catalog categories) for 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.
If the is_last field in the response is 0, proceed to request the next-level category. If is_last is 1, use interface 5105 to retrieve the part list.
Request URL:http://api.17vin.com:8080/{epc}?action=cata1&vin={vin}&user={username}&token={token}
- GET or POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| epc | Yes | string | Get epc from 3001 |
| vin | Yes | string | |
| action | Yes | string | cata1 |
| 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=cata1&vin=xxxxxxxxxxxxxxxxx')) |
{
"code": 1,
"msg": "success",
"data": {
"catalist": [{
"cata_level": 1,
"is_last": 0,
"cata_index": "1",
"cata_code": "1",
"name_en": "Tool/Engine/Fuel System",
"name_zh": "工具、引擎及燃油系统",
"remark_en": "",
"remark_zh": "",
"begin_date": "",
"end_date": "",
"illustration_img_address": "",
"Is_fit_for_this_vin": 1
},
...
{
"cata_level": 1,
"is_last": 0,
"cata_index": "4",
"cata_code": "4",
"name_en": "Electrical System",
"name_zh": "电气系统",
"remark_en": "",
"remark_zh": "",
"begin_date": "",
"end_date": "",
"illustration_img_address": "",
"Is_fit_for_this_vin": 1
}]
}
}
| Parameter | Type | Description | |
|---|---|---|---|
| cata_level | int | ||
| is_last | int | Whether it is the final level directory: 1 = yes, 0 = no. | |
| cata_index | string | ||
| cata_code | string | ||
| name_en | string | ||
| 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 |
If is_last is 1, the next step is to call interface 5105 to retrieve the parts list.