淘寶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 否 排列序号。取值範圍:大于零的整數 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 否 父類目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）