V兔API开放平台

参数	类型	必选	描述
shop_id	String	是	店铺 id
fields	String	否	需要返回的字段列表，见：ItemProp，默认返回：pid, name, must, multi, prop_values
cid	Number	是	叶子类目 ID，如果只传 cid，则只返回一级属性，通过 taobao.itemcats.get 获得叶子类目 ID
pid	Number	否	属性 id (取类目属性时，传 pid，不用同时传 PID 和 parent_pid)
parent_pid	Number	否	父属性 ID
is_key_prop	Boolean	否	是否关键属性。可选值：true(是),false(否)
is_sale_prop	Boolean	否	是否销售属性。可选值：true(是),false(否)
is_color_prop	Boolean	否	是否颜色属性。可选值：true(是),false(否) (删除的属性不会匹配和返回这个条件)
is_enum_prop	Boolean	否	是否枚举属性。可选值：true(是),false(否) (删除的属性不会匹配和返回这个条件)。如果返回 true，属性值是下拉框选择输入，如果返回 false，属性值是用户自行手工输入。
is_input_prop	Boolean	否	在 is_enum_prop 是 true 的前提下，是否是卖家可以自行输入的属性（注：如果 is_enum_prop 返回 false，该参数统一返回 false）。可选值：true(是),false(否) (删除的属性不会匹配和返回这个条件)
is_item_prop	Boolean	否	是否商品属性，这个属性只能放于发布商品时使用。可选值：true(是),false(否)
child_path	String	否	类目子属性路径，由该子属性上层的类目属性和类目属性值组成，格式 pid:vid;pid:vid.取类目子属性需要传 child_path,cid
type	Number	否	获取类目的类型：1 代表集市、2 代表天猫
attr_keys	String[]	否	属性的 Key，支持多条，以",”分隔
vvtype	Number	否	2 高级版（必须填 2,不填默认是 2）

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
last_modified	Date	2010-01-01 00:00:00	最近修改时间(只有取全量或增量的时候会返回该字段)。格式：yyyy-MM-dd HH:mm:ss
item_props	ItemProp []		类目属性信息(如果是取全量或者增量，不包括属性值),根据 fields 传入的参数返回相应的结果
--pid	Number	20000	属性 ID 例：品牌的 PID=20000
--parent_pid	Number	10000	上级属性 ID
--parent_vid	Number	24455	上级属性值 ID
--name	String	颜色	属性名
--is_key_prop	Boolean	true	是否关键属性。可选值：true(是),false(否)
--is_sale_prop	Boolean	true	是否销售属性。可选值：true(是),false(否)
--is_color_prop	Boolean	true	是否颜色属性。可选值：true(是),false(否)
--is_enum_prop	Boolean	true	是否是可枚举属性。可选值：true(是),false(否)
--is_item_prop	Boolean	true	是否商品属性。可选值：true(是),false(否)
--must	Boolean	true	发布产品或商品时是否为必选属性。可选值：true(是),false(否)
--multi	Boolean	true	发布产品或商品时是否可以多选。可选值：true(是),false(否)
--prop_values	PropValue[]
----cid	Number	50010538	类目 ID
----pid	Number	1627207	属性 ID
----prop_name	String	颜色	属性名
----vid	Number	3232483	属性值 ID
----name	String	军绿色	属性值
----name_alias	String	军绿色	属性值别名
----is_parent	Boolean	true	是否为父类目属性
----status	String	normal	状态。可选值：normal(正常),deleted(删除)
----sort_order	Number	0	排列序号。取值范围：大于零的整数
----features	Feature[]		属性值 feature
------attr_key	String	1234	属性键
------attr_value	String	2342	属性值
----status	String	normal	状态。可选值：normal(正常),deleted(删除)
----sort_order	Number	1	排列序号。取值范围：大于零的整排列序号。取值范围：大于零的整数
----child_template	String	SomeTemplate	子属性的模板（卖家自行输入属性时需要用到）
----is_allow_alias	Boolean	true	是否允许别名。可选值：true（是），false（否）
----is_input_prop	Boolean	true	在 is_enum_prop 是 true 的前提下，是否是卖家可以自行输入的属性（注：如果 is_enum_prop 返回 false，该参数统一返回 false）。可选值：true(是),false(否)。对于品牌和型号属性（包括子属性）：如果用户是 C 卖家，则可自定义属性；如果是 B 卖家，则不可自定义属性，而必须要授权的属性。
----features	Feature[]		属性的 feature 列表
------attr_key	String	1234	属性键
------attr_value	String	2342	属性值
------is_taosir	Boolean	true	是否度量衡属性项
------taosir_do	ItemTaosirDO		度量衡相关信息
--------std_unit_list	Feature[]		卖家可选单位 List< 单位 id，单位名 >
----------attr_key	String	1234	属性键
----------attr_value	String	2342	属性值
----------expr_el_list	ItemTaoSirElDO[]		表达式元素 list
------------type	Number	0	0 - 类型为 label 元素，只用于展示，不用于组装 value_name； 1 - 类型为 label 元素，用于展示，用于组装 value_name； 2 - 类型为输入狂元素，主要用于卖家输入数据。卖家填写完后需要重新设置该元素的文本数据；
------------text	String	长	显示文本
------------is_show_label	Boolean	true	是否只用于显示的文本元素
------------is_label	Boolean	false	是否文本元素，用于显示也用于组装 value_name，比如：操作符
------------is_input	Boolean	false	是否输入框
------------type	Number	0	时间类型：0 表示非时间，1 表示时间点，2 表示时间范围
------------precision	Number	2	数值小数点精度
--------is_material	Boolean	true	是否是材质属性项
--------material_do	ItemMaterialProp		材质属性信息
----------materials	ItemMateriaValueDO[]		材质值列表
------------name	String	棉(纯棉)	材质值名称
------------need_content_number	Boolean	true	当前材质值，是否需要填写含量值。比如：棉是需要填写含量值，而牛皮是不需要填写含量值的
withholding_money	int		该接口扣费金额（点券）

返回数据

{"code": 0, "msg": "操作成功", "msec": 1469, "time": 1617270403, "data": {"withholding_money":1,itemprops_get_response": {"last_modified": "2010-01-01 00:00:00", "item_props": {"item_prop": [{"pid": 20000, "parent_pid": 10000, "parent_vid": 24455, "name": "颜色", "is_key_prop": true, "is_sale_prop": true, "is_color_prop": true, "is_enum_prop": true, "is_item_prop": true, "must": true, "multi": true, "prop_values": {"prop_value": [{"cid": 50010538, "pid": 1627207, "prop_name": "颜色", "vid": 3232483, "name": "军绿色", "name_alias": "军绿色", "is_parent": true, "status": "normal", "sort_order": 0, "features": {"feature": [{"attr_key": "1234", "attr_value": "2342"}]}}]}, "status": "normal", "sort_order": 1, "child_template": "SomeTemplate", "is_allow_alias": true, "is_input_prop": true, "features": {"feature": [{"attr_key": "1234", "attr_value": "2342"}]}, "is_taosir": true, "taosir_do": {"std_unit_list": {"std_unit": [{"attr_key": "1234", "attr_value": "2342"}]}, "expr_el_list": {"expr_el": [{"type": 0, "text": "长", "is_show_label": true, "is_label": false, "is_input": false}]}, "type": 0, "precision": 2}, "is_material": true, "material_do": {"materials": {"item_materia_value_d_o": [{"name": "棉(纯棉)", "need_content_number": true}]}}}]}}}}

响应代码

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

获取标准商品类目属性

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情