淘宝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 排列序号，表示同级类目的展现次序，如数值相等则按名称次序排列。取值范围:大于零的整数

原文出自：http://keko-boy-163-com.iteye.com/admin/blogs/1893792