V兔API开放平台

参数	类型	必选	示例	描述
shop_id	String	true	1234455	店铺 id
cids	Number[]	false	18957,1956	商品所属类目 ID 列表，用半角逗号(,)分隔例如：(18957,19562,) (cids、parent_cid 至少传一个)
datetime	Date	false	2000-01-01 00:00:00	无效字段，暂无法使用。时间戳（格式：yyyy-MM-dd HH:mm:ss）如果该字段没有传，则取当前所有的类目信息，如果传了 parent_cid 或者 cids，则忽略 datetime，如果该字段传了，那么可以查询到该时间到现在为止的增量变化
fields	String[]	false	cid,parent_cid,name,is_parent	需要返回的字段列表，见 ItemCat，默认返回：cid,parent_cid,name,is_parent；增量类目信息，根据 fields 传入的参数返回相应的结果。 features 字段：1、如果存在 attr_key=freeze 表示该类目被冻结了，attr_value=0,5，value 可能存在 2 个值（也可能只有 1 个），用逗号分割，0 表示禁编辑，5 表示禁止发布
parent_cid	Number	false	50011999	父商品类目 id，0 表示根节点，传输该参数返回所有子类目。 (cids、parent_cid 至少传一个)
vvtype	Number	false	2	2 高级版（必须填 2,不填默认是 2）
cids,datetime,parent_cid 必传其中一个

请求示例

shop_id:1564199
datetime:2017-04-23 16:45:12

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
last_modified	Date	2015-01-01 00:00:00	最近修改时间(如果取增量，会返回该字段)。
item_cats	ItemCat []		商品类目结构
cid	Number	50011999	商品所属类目 ID
parent_cid	Number	0	父类目 ID=0 时，代表的是一级的类目
name	String	单方精油	类目名称
is_parent	Boolean	true	该类目是否为父类目(即：该类目是否还有子类目)
status	String	normal	状态。可选值：normal(正常),deleted(删除)
sort_order	Number	1	排列序号，表示同级类目的展现次序，如数值相等则按名称次序排列。取值范围：大于零的整数
features	Feature[]		Feature 对象列表目前已有的属性：若 Attr_key 为 udsaleprop，attr_value 为 1 则允许卖家在改类目新增自定义销售属性，不然为不允许
attr_key	String	1234	属性键
attr_value	String	2342	属性值
taosir_cat	Boolean	false	是否度量衡类目
withholding_money	int		该接口扣费金额（点券）

返回数据

{"code": 0, 
"msg": "操作成功",
 "msec": 1469, 
 "time": 1617270403, 
 "data": {
     "withholding_money":1,
    "itemcats_get_response":{
        "last_modified":"2015-01-01 00:00:00",
        "item_cats":{
            "item_cat":[
                {
                    "cid":50011999,
                    "parent_cid":0,
                    "name":"单方精油",
                    "is_parent":true,
                    "status":"normal",
                    "sort_order":1,
                    "features":{
                        "feature":[
                            {
                            }
                        ]
                    },
                    "taosir_cat":false
                }
            ]
        }
    }
}}

响应代码

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