淘宝API-类目

 

1.类目API

提供了标准类目，类目属性和类目属性值的查询功能

1.1API列表

taobao.itemcats.authorize.get查询商家被授权品牌列表和类目列表
taobao.itemcats.get获取后台供卖家发布商品的标准商品类目
taobao.itemcats.increment.get增量获取后台类目数据
taobao.itemprops.get获取标准商品类目属性
taobao.itempropvalues.get获取标准类目属性值
taobao.topats.itemcats.get全量获取后台类目数据

1.2数据结构列表

Feature类目属性
PropValue属性值
SellerAuthorize授权
ItemProp商品属性
Task批量异步任务结果
Subtask批量异步任务的子任务结果
Brand品牌
ItemCat商品类目结构

1.2数据结构详细

Feature

简要描述

类目属性

属性

名称类型是否隐私示例值描述

attr_key	String	否	1234	属性键
attr_value	String	否	2342	属性值

PropValue

简要描述

属性值

属性

名称类型是否隐私示例值描述

modified_time	Date	否	2000-01-01 00:00:00	修改时间（类目增量专用）
modified_type	String	否	add	三种枚举类型：modify，add，delete (增量类目专用)
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	排列序号。取值范围:大于零的整数

SellerAuthorize

简要描述

授权

属性

名称类型是否隐私示例值描述

xinpin_item_cats	ItemCat []	否		被授权的新品类目列表
item_cats	ItemCat []	否		类目列表
brands	Brand []	否		品牌列表

ItemProp

简要描述

商品属性

属性

名称类型是否隐私示例值描述

is_input_prop	Boolean	否	true	在is_enum_prop是true的前提下，是否是卖家可以自行输入的属性（注：如果is_enum_prop返回false，该参数统一返回false）。可选值:true(是),false(否)。对于品牌和型号属性（包括子属性）：如果用户是C卖家，则可自定义属性；如果是B卖家，则不可自定义属性，而必须要授权的属性。
type	String	否	enum	属性值类型。可选值：multiCheck(枚举多选)optional(枚举单选)multiCheckText(枚举可输入多选)optionalText(枚举可输入单选)text(非枚举可输入)
modified_time	Date	否	2000-01-01 00:00:00	属性修改时间（增量类目专用）
modified_type	String	否	add	三种枚举类型：modify，add，delete（增量类目专用）
cid	Number	否	16	类目ID
required	Boolean	否	true	发布产品或商品时是否为必选属性(与must相同)。可选值:true(是),false(否)
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 []	否
status	String	否	normal	状态。可选值:normal(正常),deleted(删除)
sort_order	Number	否	1	排列序号。取值范围:大于零的整排列序号。取值范围:大于零的整数
child_template	String	否	SomeTemplate	子属性的模板（卖家自行输入属性时需要用到）
is_allow_alias	Boolean	否	true	是否允许别名。可选值：true（是），false（否）

Task

简要描述

批量异步任务结果

属性

名称类型是否隐私示例值描述

download_url	String	否	http://download.api.taobao.com/download?id=bacnoiewothoi	大任务结果下载地址。当创建的认任务是大数据量的任务时，获取结果会返回此字段，同时subtasks列表会为空。 通过这个地址可以下载到结果的结构体，格式同普通任务下载的一样。 每次获取到的地址只能下载一次。下载的文件加上后缀名.zip打开。
check_code	String	否	efdbe2545a01aff317f0cbaad6663c7c	下载文件的MD5校验码，通过此校验码可以检查下载的文件是否是完整的。
schedule	Date	否	2000-01-01 00:00:00	定时类型任务的执行时间点
task_id	Number	否	12345	异步任务id。创建异步任务时返回的任务id号
status	String	否	done	异步任务处理状态。new（还未开始处理），doing（处理中），done（处理结束）。
subtasks	Subtask []	否		子任务处理结果，如果任务还没有处理完，返回的结果列表为空。如果任务处理完毕，返回子任务结果列表
method	String	否	taobao.topats.trades.fullinfo.get	此任务是由哪个api产生的
created	Date	否	2000-01-01 00:00:00	任务创建时间

Subtask

简要描述

批量异步任务的子任务结果

属性

名称类型是否隐私示例值描述

sub_task_request	String	否	{"tid":123456,"fields":"tid,seller_nick"}	子任务的有效请求参数，以json格式进行key:value的组合
sub_task_result	String	否	{“trade”:{"tid":123456,"seller_nick":"淘宝卖家"}}	子任务返回的结果，以json格式进行key:value组合，可以和单个api请求结果解析复用。以获取交易订单详情为例：子任务执行成功返回的结果格式为：{“trade”:{"tid":123456,"seller_nick":"淘宝卖家"}}；子任务执行失败结果格式为{"sub_code":"isv.trade-not-exist","sub_msg":"交易订单不存在"}
is_success	Boolean	否	true	标记子任务是否成功。为true表示子任务成功，用户可以按照正确执行的结果格式解析sub_task_result。为false表示子任务失败了，用户需要按照失败的结果格式解析sub_task_result（里面只有sub_code和sub_msg）

Brand

简要描述

品牌

属性

名称类型是否隐私示例值描述

vid	Number	否	3709439	对应属性的 pid:vid 串中的vid
name	String	否	测试品牌	vid的值
pid	Number	否	20000	品牌的属性id
prop_name	String	否	品牌	品牌的属性名

ItemCat

简要描述

商品类目结构

属性

名称类型是否隐私示例值描述

features	Feature []	否		Feature对象列表 目前已有的属性： 若Attr_key为 udsaleprop，attr_value为1 则允许卖家在改类目新增自定义销售属性,不然为不允许
modified_type	String	否	modify	三种枚举类型：modify，add，delete（增量类目api使用）
modified_time	Date	否	2000-01-01 00:00:00	增量类目：修改时间
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	排列序号，表示同级类目的展现次序，如数值相等则按名称次序排列。取值范围:大于零的整数

原文出自：IT博客吧（http://www.itblog8.cn/java/20130625193.html）