V兔API开放平台

参数	类型	必选	示例	描述
shop_id	String	true	店铺 ID
fields	String	true	product_id,outer_id	需返回的字段列表。可选值：Product 数据结构中的所有字段;多个字段之间用","分隔。
product_id	Number	false	86126527	Product 的 id.两种方式来查看一个产品：1.传入 product_id 来查询 2.传入 cid 和 props 来查询
cid	Number	false	50012286	商品类目 id.调用 taobao.itemcats.get 获取;必须是叶子类目 id,如果没有传 product_id,那么 cid 和 props 必须要传。
props	String	false	10005:10027;10006:29729	比如：诺基亚 N73 这个产品的关键属性列表就是：品牌：诺基亚;型号：N73,对应的 PV 值就是 10005:10027;10006:29729.
vvtype	Number	false		普通版 1，不传默认 1，增强版 2，增强版的需要传参 2，标准版 3,需要标准版的传 3

请求示例

shop_id:123456
fields:product_id,outer_id

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
product	Product		返回具体信息为入参 fields 请求的字段信息
name	String	惠普笔记本	产品名称
binds	String	pid:vid;pid:vid	产品的非关键属性列表。格式：pid:vid;pid:vid.
sale_props	String	pid:vid;pid:vid	产品的销售属性列表。格式：pid:vid;pid:vid
price	Price	200.07	产品的市场价。单位为元。精确到 2 位小数;如：200.07
desc	String	这是一款产品	产品的描述。最大 25000 个字节
pic_url	String	http://host/image_path	产品的主图片地址。(绝对地址，格式：http://host/image_path)
modified	Date	2000-01-01 00:00:00	修改时间。格式：yyyy-mm-dd hh:mm:ss
product_prop_imgs	ProductPropImg[]		产品的属性图片。比如说黄色对应的产品图片，绿色对应的产品图片。fields 中设置为 product_prop_imgs.id、 product_prop_imgs.props、product_prop_imgs.url、product_prop_imgs.position 等形式就会返回相应的字段
id	Number	674443	产品属性图片 ID
product_id	Number	96899	图片所属产品的 ID
props	String	颜色：红色表示为　1627207:28326	属性串(pid:vid),目前只有颜色属性。如：颜色：红色表示为　1627207:28326
url	String	http://host/image_path	图片地址。(绝对地址，格式：http://host/image_path)
position	Number	2355	图片序号。产品里的图片展示顺序，数据越小越靠前。要求是正整数。
created	Date	2000-01-01 00:00:00	添加时间。格式：yyyy-mm-dd hh:mm:ss
modified	Date	2000-01-01 00:00:00	修改时间。格式：yyyy-mm-dd hh:mm:ss
status	Number	1	当前状态(0 商家确认 1 屏蔽 3 小二确认 2 未确认 -1 删除)
vertical_market	Number	3	垂直市场，如：3（3C），4（鞋城）
customer_props	String	20000:优衣库	用户自定义属性，结构：pid1:value1;pid2:value2 例如：“20000:优衣库”，表示“品牌：优衣库”
property_alias	String	1627207:3232483:深深绿色	销售属性值别名。格式为 pid1:vid1:alias1;pid1:vid2:alia2。
product_id	Number	3433222	产品 ID
outer_id	String	123456	外部产品 ID
created	Date	2000-01-01 00:00:00	创建时间。格式：yyyy-mm-dd hh:mm:ss
tsc	String	hkjki	淘宝标准产品编码
cid	Number	50012286	商品类目 ID.必须是叶子类目 ID
cat_name	String	日用品	商品类目名称
props	String	pid:vid;pid:vid	产品的关键属性列表。格式：pid:vid;pid:vid
props_str	String	品牌：诺基亚;型号：N73	产品的关键属性字符串列表。比如：品牌：诺基亚;型号：N73(注：属性名称中的冒号":"被转换为："#cln#"; 分号";"被转换为："#scln#")
binds_str	String	品牌：诺基亚;型号：N73	产品的非关键属性字符串列表。格式同 props_str(注：属性名称中的冒号":"被转换为："#cln#"; 分号";"被转换为："#scln#")
sale_props_str	String	品牌：诺基亚;型号：N73	产品的销售属性字符串列表。格式同 props_str(注：属性名称中的冒号":"被转换为："#cln#"; 分号";"被转换为："#scln#")
product_imgs	ProductImg[]		产品的子图片。目前最多支持 4 张。fields 中设置为 product_imgs.id、product_imgs.url、product_imgs.position 等形式就会返回相应的字段
id	Number	9684	产品图片 ID
product_id	Number	96899	图片所属产品的 ID
url	String	http://host/image_path	图片地址。(绝对地址，格式：http://host/image_path)
position	Number	2355	图片序号。产品里的图片展示顺序，数据越小越靠前。要求是正整数。
created	Date	2000-01-01 00:00:00	添加时间。格式：yyyy-mm-dd hh:mm:ss
modified	Date	2000-01-01 00:00:00	修改时间。格式：yyyy-mm-dd hh:mm:ss
sell_pt String 明星同款产品卖点描述，长度限制 20 个汉字
withholding_money	INT	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
        "withholding_money": 1,
    "product_get_response":{
        "product":{
            "name":"惠普笔记本",
            "binds":"pid:vid;pid:vid",
            "sale_props":"pid:vid;pid:vid",
            "price":"200.07",
            "desc":"这是一款产品",
            "pic_url":"http:\/\/host\/image_path",
            "modified":"2000-01-01 00:00:00",
            "product_prop_imgs":{
                "product_prop_img":[
                    {
                    }
                ]
            },
            "status":1,
            "vertical_market":3,
            "customer_props":"20000:优衣库",
            "property_alias":"1627207:3232483:深深绿色",
            "product_id":3433222,
            "outer_id":"123456",
            "created":"2000-01-01 00:00:00",
            "tsc":"hkjki",
            "cid":50012286,
            "cat_name":"日用品",
            "props":"pid:vid;pid:vid",
            "props_str":"品牌:诺基亚;型号:N73",
            "binds_str":"品牌:诺基亚;型号:N73",
            "sale_props_str":"品牌:诺基亚;型号:N73",
            "product_imgs":{
                "product_img":[
                    {
                    }
                ]
            },
            "sell_pt":"明星同款"
        }
    }
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确