唯品会的两个常用API分享（商品详情和关键字搜索）

痛定思痛。 2024-03-03 07:30 50阅读 0赞

## 万邦vip API 接入说明 ##

1.  API地址:  
    [https://api-test.cn/vip/][https_api-test.cn_vip]
2.  调用示例：

> -- 请求示例 url 默认请求参数已经URL编码处理
> curl -i "https://api-服务器.cn/vip/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=1710613157-6918711233889249157"

1. 参数说明
 
 * 通用参数说明
 
 * url说明 https://api-gw.onebound.cn/平台/API类型/ 平台：淘宝，京东等， API类型:\[item\_search,item\_get,item\_search\_shop等\]
 * version:API版本
 * key:调用key,测试key:test\_api\_key
 * secret:调用secret,测试secret:(不用填写)
 * cache:\[yes,no\]默认yes，将调用缓存的数据，速度比较快
 * result\_type:\[json,xml,serialize,var\_export\]返回数据格式，默认为json
 * lang:\[cn,en,ru\] 翻译语言，默认cn简体中文
 * secret:密钥
 * API:item\_search 参数说明：
 
 * q:搜索关键字
 * cat:分类ID
 * start\_price:开始价格
 * end\_price:结束价格
 * sort:排序\[bid,*bid,bid2,\_bid2,\_sale,\_credit\] 
 (bid:总价,bid2:商品价格,sale:销量,credit信用,加*前缀为从大到小排序)
 * page:页数
 * page\_size:每页宝贝数量，默认40
 * seller\_info:是否获取商家信息\[yes,no\],默认yes
 * API:item\_get 参数说明: num\_iid:宝贝ID
2. 此API目前支持以下基本接口：
 
 * item\_get 获得vip商品详情
 * item\_search 按关键字搜索vip商品
3. 公共参数
 
 请求地址: https://api-gw.onebound.cn/vip/item\_get
 
 <table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>key</td> 
 <td>String</td> 
 <td>是</td> 
 <td>调用key（必须以GET方式拼接在URL中）</td> 
 </tr> 
 <tr> 
 <td>secret</td> 
 <td>String</td> 
 <td>是</td> 
 <td>调用密钥</td> 
 </tr> 
 <tr> 
 <td>api_name</td> 
 <td>String</td> 
 <td>是</td> 
 <td>API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]</td> 
 </tr> 
 <tr> 
 <td>cache</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[yes,no]默认yes，将调用缓存的数据，速度比较快</td> 
 </tr> 
 <tr> 
 <td>result_type</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读</td> 
 </tr> 
 <tr> 
 <td>lang</td> 
 <td>String</td> 
 <td>否</td> 
 <td>[cn,en,ru]翻译语言，默认cn简体中文</td> 
 </tr> 
 <tr> 
 <td>version</td> 
 <td>String</td> 
 <td>否</td> 
 <td>API版本</td> 
 </tr> 
 </tbody> 
 </table>
 
 请求参数
 
 请求参数：num\_iid=1710613157-6918711233889249157
 
 参数说明：num\_iid:店铺ID-商品ID
 
 响应参数
 
 Version: Date:
 
 <table> 
 <thead> 
 <tr> 
 <th>名称</th> 
 <th>类型</th> 
 <th>必须</th> 
 <th>示例值</th> 
 <th>描述</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td> num_iid </td> 
 <td>Bigint</td> 
 <td>0</td> 
 <td>969908-145512642</td> 
 <td>宝贝ID</td> 
 </tr> 
 <tr> 
 <td> title </td> 
 <td>String</td> 
 <td>0</td> 
 <td>男童白底满印熊猫大侠短袖包屁衣</td> 
 <td>宝贝标题</td> 
 </tr> 
 <tr> 
 <td> desc_short </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品简介</td> 
 </tr> 
 <tr> 
 <td> price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>49.00</td> 
 <td>价格</td> 
 </tr> 
 <tr> 
 <td> total_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> suggestive_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> orginal_price </td> 
 <td>Float</td> 
 <td>0</td> 
 <td>109.00</td> 
 <td>原价</td> 
 </tr> 
 <tr> 
 <td> nick </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>掌柜昵称</td> 
 </tr> 
 <tr> 
 <td> num </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> min_num </td> 
 <td>Int</td> 
 <td>0</td> 
 <td>0</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> detail_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td>http://www.vip.com/detail-969908-145512642.html</td> 
 <td>宝贝链接</td> 
 </tr> 
 <tr> 
 <td> pic_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>宝贝图片</td> 
 </tr> 
 <tr> 
 <td> brand </td> 
 <td>String</td> 
 <td>0</td> 
 <td>功夫熊猫</td> 
 <td>品牌名称</td> 
 </tr> 
 <tr> 
 <td> brandId </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>品牌ID</td> 
 </tr> 
 <tr> 
 <td> rootCatId </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>顶级分类ID</td> 
 </tr> 
 <tr> 
 <td> cid </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> crumbs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> created_time </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> modified_time </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> delist_time </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> desc </td> 
 <td>String</td> 
 <td>0</td> 
 <td> <img alt="" height="299" src="https://img-home.csdnimg.cn/images/20230724024159.png?origin_url=https%3A%2F%2Fopen.onebound.cn%2F%2522%2F%2Fa.vpimg3.com%2Fupload%2Fmerchandise%2Fother%2F440246%2FKFP-8523077W00-6.jpg%2F%2522&amp;pos_id=Gwmr8Of1" width="534"> </td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> desc_img </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>["//a.vpimg3.com/upload/merchandise/other/440246/KFP-8523077W00-6.jpg"]</td> 
 <td>描述图片</td> 
 </tr> 
 <tr> 
 <td> item_imgs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td>商品图片</td> 
 </tr> 
 <tr> 
 <td> item_weight </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> item_size </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> location </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>发货地</td> 
 </tr> 
 <tr> 
 <td> post_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td></td> 
 <td>物流费用</td> 
 </tr> 
 <tr> 
 <td> express_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td></td> 
 <td>快递费用</td> 
 </tr> 
 <tr> 
 <td> ems_fee </td> 
 <td>Float</td> 
 <td>0</td> 
 <td></td> 
 <td>EMS费用</td> 
 </tr> 
 <tr> 
 <td> shipping_to </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>发货至</td> 
 </tr> 
 <tr> 
 <td> has_discount </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> video </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td>商品视频</td> 
 </tr> 
 <tr> 
 <td> is_virtual </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> sample_id </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品风格标识ID</td> 
 </tr> 
 <tr> 
 <td> is_promotion </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> props_name </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品属性名</td> 
 </tr> 
 <tr> 
 <td> prop_imgs </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"prop_img": []}</td> 
 <td>商品属性图片列表</td> 
 </tr> 
 <tr> 
 <td> property_alias </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>商品属性别名</td> 
 </tr> 
 <tr> 
 <td> props </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[{ "name": "夏","value": "常规" }]</td> 
 <td>商品详情</td> 
 </tr> 
 <tr> 
 <td> total_sold </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> skus </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"sku": []</td> 
 <td>商品规格信息</td> 
 </tr> 
 <tr> 
 <td> seller_id </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>卖家ID</td> 
 </tr> 
 <tr> 
 <td> sales </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>销量</td> 
 </tr> 
 <tr> 
 <td> shop_id </td> 
 <td>Int</td> 
 <td>0</td> 
 <td></td> 
 <td>店铺ID</td> 
 </tr> 
 <tr> 
 <td> props_list </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td>商品属性</td> 
 </tr> 
 <tr> 
 <td> seller_info </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>{"nick": "", "city": "", "level": "", "rate": "", "shop_type": "", "user_num_id": "", "shopid": "", "shopname": "", "shop_href": "", "tel": "", "menu": [] }</td> 
 <td>卖家信息</td> 
 </tr> 
 <tr> 
 <td> tmall </td> 
 <td>Boolean</td> 
 <td>0</td> 
 <td></td> 
 <td>是否天猫</td> 
 </tr> 
 <tr> 
 <td> error </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>错误信息</td> 
 </tr> 
 <tr> 
 <td> warning </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td>警告信息</td> 
 </tr> 
 <tr> 
 <td> url_log </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> stuff_status </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> data_from </td> 
 <td>String</td> 
 <td>0</td> 
 <td>app_vip</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> method </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> promo_type </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> props_img </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td>属性图片</td> 
 </tr> 
 <tr> 
 <td> rate_grade </td> 
 <td>String</td> 
 <td>0</td> 
 <td></td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> priceRange </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> shop_item </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> relate_items </td> 
 <td>Mix</td> 
 <td>0</td> 
 <td>[]</td> 
 <td></td> 
 </tr> 
 <tr> 
 <td> shop_url </td> 
 <td>String</td> 
 <td>0</td> 
 <td>https://list.vip.com/brand.html?sn=10020198</td> 
 </tr> 
 </tbody> 
 </table>

[https_api-test.cn_vip]: https://o0b.cn/jennif