5107.Search OE Part Name via VIN
Brief Summary:- Search for basic category information using an EPC OEM part name (Original Equipment Manufacturer). This interface supports exact matching only. Before use, first retrieve all OEM part names for the VIN via interface 5110. For fuzzy search functionality, implement it client-side after retrieving OEM names via 5110. This allows greater flexibility and enables users to customize their own fuzzy search algorithms. Critical Notes for International Users
Due to limited support for non-Chinese OEM part names in 17VIN's system, international users are strongly advised to:
Maintain a Local Database
Create a local database mapping OE numbers to part names (Chinese/English).
Use interface 5109 to retrieve all OE numbers for a VIN first.
Match these OE numbers to your local database to obtain part names.
Perform fuzzy search logic client-side using your own part name database.
Finally, use interface 5106 to query details by OE number.
Long-Term Partnership Option
For enterprises requiring comprehensive data, 17VIN can provide the full EPC OE list (containing tens of millions of OE numbers) and corresponding part names (primarily Chinese/English). Contact our sales team to discuss requirements and delivery methods.
Request URL:http://api.17vin.com:8080/{epc}?action=search_epc_part_name&vin={vin}&query_match_type={query_match_type}&query_part_name={query_part_name}&query_part_name_is_safebase64={query_part_name_is_safebase64}&user={username}&token={token}
- query_part_name_is_safebase64=1
- query_part_name_is_safebase64=0
- GET or POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| epc | Yes | string | Get epc from 3001 |
| action | Yes | string | search_epc_part_name |
| vin | Yes | string | |
| query_match_type | Yes | string | exact,inexact |
| query_part_name | Yes | string | |
| query_part_name_is_safebase64 | No | int | 1: encrypted, 0: not encrypted (default value: 1) If query_part_name_is_safebase64=1,query_part_name=part_name.Base64.Replace("/", "_").Replace("+", "-") |
| 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=search_epc_part_name&vin=xxxxxxxxxxxxxxxxx&query_match_type=exact&query_part_name=xxxxxx&query_part_name_is_safebase64=1’)) |
{
"code":1,
"msg":"success",
"data":{
"searchlist":[
{
"cata_level":"2",
"cata_name_en":"STANDARD TOOL",
"cata_name_zh":"标准工具",
"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":null,
"remark_en":"NO.2",
"remark_zh":null,
"sort":null,
"is_fit_for_this_vin":1
},
{
"cata_level":"2",
"cata_name_en":"STANDARD TOOL",
"cata_name_zh":"标准工具",
"illustration_img_address":"090562C.png",
"callout":"09114",
"cata_code":"0901_090562C-0001",
"partnumber_original":"091140G020",
"partnumber":"091140G020",
"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":null,
"remark_en":"NO.1",
"remark_zh":null,
"sort":null,
"is_fit_for_this_vin":1
}
]
}
}
Response searchlist
| Parameter | Type | Description | |
|---|---|---|---|
| cata_level | string | ||
| cata_name_en | string | ||
| cata_name_zh | string | ||
| cata_code | string | ||
| 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 |