5112.Search Suggestions for Parts via VIN
Brief Summary:- Generate search suggestions based on a user-provided query term (supports OE numbers or part names) for a specific VIN. This interface returns matching suggestions to help users refine their search before querying detailed parts data via 5106 (Part Number), 5107 (EPC OEM Name), or 5108 (Standard Part Name).
Critical Note for International Users:
⚠️ Not recommended for international users.
→ Recommended Workflow:
Use 5109 (Get All OE Part Numbers) to retrieve all OE numbers for the VIN.
Match these numbers to your local database (e.g., for English/Chinese part names).
Perform client-side fuzzy search using your local data.
Query detailed parts via 5106 (OE Number).
Request URL:http://api.17vin.com:8080/{epc}?action=search_suggest&suggest_key=刹车&vin={vin}&user={username}&token={token}
- part name search
- oe number search
- GET or POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| epc | Yes | string | Get epc from 3001 |
| action | Yes | string | search_suggest |
| vin | Yes | string | |
| suggest_key | Yes | string | Search Keyword: Supports OE numbers or part names as search keywords. |
| user | Yes | string | user name |
| token | Yes | string | MD5(concat(MD5('myusername'),MD5('mypassword'),'/xxx?action=search_suggest&suggest_key=xxxxxx&vin=xxxxxxxxxxxxxxxxx')) |
{
"code":1,
"data":[
{
"action":"search_std_part_name",
"keyword":"前刹车片(套)"
},
{
"action":"search_std_part_name",
"keyword":"后刹车片(套)"
},
{
"action":"search_epc_part_name",
"keyword":"刹车灯控制ecu总成"
}
],
"msg":"success"
}
Response description
| Parameter | Type | Description |
|---|---|---|
| code | string | 1 (Success), 0 (Failure) |
| msg | string | success or err msg |
| data>action | string | Search action type: Three possible values: search_epc_part_name (interface 5107), search_std_part_name (interface 5108), search_part_number (interface 5106). |
| data>keyword | string | Matching full part name or part number |