API接口doc文檔20120523

1、京東API商品接口文檔類目API1 .獲取商家類目信息接口名稱360buy.warecats.get功能說明根據(jù)商家id獲取商家已經(jīng)開通的類目。系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvStrin

2、g是API協(xié)議版本，可選值 2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述fieldsString是id,fid,status,lev,name,index_id需返回的字段列表。返回結果名稱是否必須示例值描述item_catsList<category>是類目信息codecategory 結構名稱示例值描述idnumber2323類目idindex_idnumber12314排序（越小越靠前）fidnumber123122父類目idnameString類目名稱Is_parentbooleantrue該類目是否為父類目（即：該類目是否還 有子類目）statusstringvalid類

3、目狀態(tài)(deleted , unvalid, valid )levnumber1等級（類目分為1、2、3級）返回示例JSONR據(jù)格式"ware_category_search_response": "item_cats":"name":"高清播放器","id": 1261,"status": "valid","lev": 3,"fid": 794, "name":"面膜面貼",

4、"id": 6543,"status": "valid","lev": 3,"fid": 6355, "name": "T 恤"，"id": 1349,"status": "valid","lev": 3, "fid": 1342,"total": 3,"code": "0" SDK調用示例(jav

5、a )public JdClient client = new DefaultJdClient(SERVER_URL,”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66293AD391EE7E4E9515“ ，" 0da953632d0a4741beb0bbd096214605” )；CategorySearchRequest request = new CategorySearchRequest();CategorySearchResponse response=client.execute(request);

6、2 .獲取類目屬性信息接口名稱360buy.ware.get.attribute功能說明獲取類目下的屬性信息。系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0

7、.應用級輸入?yún)?shù)名稱是否必須示例值描述fieldsString是aid,name,is_key_prop,is_sale_prop,index_id,status,att_type,input_type,需返回的字段列表。is_req,is_fet,is_nav,cidcidnumber是類目idis_key_propboolean否true是否關鍵屬性（true/false）is_sale_propboolean否false是否銷售屬性（true/false）aidnumber否屬性id返回結果名稱是否必須示例值描述attributesList<attributes>是類目屬性信

8、息attribute 結構名稱示例值描述aidnumber2323屬性idnamestring12314屬性名booleanfalseis_key_prop關鍵屬性is_sale_propbooleantrue銷售屬性numberindex id排序（越小越靠前）statusnumber1狀態(tài)att_typenumber屬性類型1、關鍵屬性2、不變屬性3、可變屬性4、銷售屬性input_typenumber輸入類型（1、單選，2、多選3、輸入（最大50個字符）is_reqbooleantrue是否必填trueis fetboolean是否篩選is_navbooleantrue是否導航返回示例J

9、SONR據(jù)格式"category_attribute_search_response": "attributes":"name":"價格"， "status": "valid", "input_type"： 1, "cid": "1575", "index_id": 1, "aid": 3756, "att_type": "3", &qu

10、ot;is_req": "false", "is_fet": "true", "is_nav": "false" ,"name":"品牌"， "status": "valid", "input_type": 1, "cid": "1575", "index_id": 1, "aid": 3755, "

11、;att_type": "3", "is_req": "false", "is_fet": "true", "is_nav": "false" ,"total": 2, "code": "0"ISDK調用示例(java )public JdClient client = new DefaultJdClient(SERVER_URL, "c7b82199-f26d-459e-a4

12、b3-d6f6cec4b869", " 36AB8642CCEF66293AE7E4E95 15“ ，" 0da953632d0a4741beb0bbd096214605” )； CategoryAttributeSearchRequest request = new CategoryAttributeSearchRequest() request.setCid("4001");CategoryAttributeSearchResponse response=client.execute(request);3 .獲取類目屬性值信息360buy.

13、ware.get.attvalue功能說明獲取類目下的屬性值信息。系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值：2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述fie

14、ldsString是aid,vid,name,status,index_id需返回的字段列表。avsstring是屬性和屬性值id 串，格式例如 (pid1;pid2)或(pid1:vid1;pid2:vid2) 或(pid1;pid2:vid2)返回結果名稱是否必須示例值描述att_valuesList<AttValue>是類目屬性值信息AttValue 結構名稱示例值描述aidnumber2323屬性idvidnumber12314屬性值idnamestring屬性值名字statusstringunvalid狀態(tài)(deleted , unvalid , valid )index

15、_idnumber排序(越小越靠前)返回示例JSONR據(jù)格式("category_attribute_value_response”: "att_values":."name":"0-99", "status":"valid", "index_id":1, "aid":3206, "vid":22106，"name":"秋水之韻", "status":"va

16、lid","index_id":91,"aid":3205,"vid":65556,"total”:2,"code":"0"SDK調用示例(java )public JdClient client = new DefaultJdClient(SERVER_URL,”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66293AD391EE7E4E95 15“ ，" 0da953632d0a4741be

17、b0bbd096214605” )；CategoryAttributeValueSearchRequest request = newCategoryAttributeValueSearchRequest();request.setAvs("8739");CategoryAttributeValueSearchResponse response=client.execute(request);二、商品API1 .添加商品接口名稱360buy.ware.add功能說明新增一個商品系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenS

18、tring是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值：2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述cidString是1354類目idshop_categoryString206-208;207-208206（ 一 級）-208（二級）;207（一級）-207（一級）

19、店內分類TitleString是標題upc_codeStringupc編碼option_typeString操作類型，現(xiàn)只支持：offsaleitem_numString貨號ProducterString生產(chǎn)1商WrapString包裝規(guī)格LengthString是長WideString是寬HighString是高WeightString是cost_priceString進貨價market_priceString是市場價jd_priceString是京東價NotesString是描述ware_imageByte口是圖片信息pack_listingString包裝清單ServiceString售

20、后服務stock_numString是庫存數(shù)AttributesString是3205:22101|3205:22102商品屬性列表，格式:pid:vid;pid:vid|pid1:vid1;pid1:vid1sku_pricesString12|13sku價格，格式：p1|p2sku_propertiesString100041:150041A1000046:15844|1001:1501A10006:1504sku 屬性，格式:aid:vidAaid1:vid2|aid3:vid3Aaid4:vid4sku_stocksStringsku庫存，格式：s1|s2trade_noString流

21、水號返回結果名稱是否必須示例值描述createdString更改時間ware_idlong商品的idcodeString錯誤碼返回示例JSONR據(jù)格式("ware_update_listing_response": "ware_id": 1100000015, "created": "2012-01-06 11:13:19”, "code": "0"SDK調用示例（java ）E95public JdClient client = new DefaultJdClient(SERVER_

22、URL,”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66293AD391EE7 15“ ，" 0da953632d0a4741beb0bbd096214605” )；WareAddRequest wareAddRequest= new WareAddRequest();wareAddRequest.setCategoryId("1354");/類目 服飾鞋帽 > 女裝 > 襯衫(1354) 藥品 > 感冒用藥 > 風寒風熱(6359)wareAddRequest.se

23、tWareImage(imageFactory(); /主圖wareAddRequest.setTitle("API商品測試-商品稱 1111");wareAddRequest.setLength("1");wareAddRequest.setWide("2");wareAddRequest.setHigh("3");wareAddRequest.setWeight("11");wareAddRequest.setMarketPrice("500"); /市場價 wareAd

24、dRequest.setJdPrice("444"); / 京東價 wareAddRequest.setNotes(描述 123123<br />");/ 描述 wareAddRequest.setPackListing但裝滿單");/ 包裝清單 wareAddRequest.setService(W后服務");/ 售后服務wareAddRequest.setStockNum("100");wareAddRequest.setAttributes("3205:64734|3206:22107"

25、);wareAddRequest.setSkuProperties("1000000041:150029941A1000000046:150029 944|1000000041:150029941A1000000046:150029943");wareAddRequest.setSkuPrices("300|500");2 .修改商品接口名稱360buy.ware.update.listing功能說明通過api根據(jù)ware_id商品編號 操作商品上架系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenStrin

26、g是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述ware_idString是1354商品idshop_categoryString206-208;207-208206（ 一 級）-208（二級）;207（一級）-207（一級）

27、店內分類titleString是標題upc_codeStringupc編碼option_typeString操作類型，現(xiàn)只支持：offsaleitem_numString貨號producterString生產(chǎn)1商wrapString包裝規(guī)格lengthString是長wideString是寬highString是高weightString是cost_priceString進貨價market_priceString是市場價jd_priceString是京東價notesString是描述pack_listingString包裝清單ServiceString售后服務attributesString是

28、3205:22101|3205:22102商品屬性列表，格式:pid:vid;pid:vid|pid1:vid1;pid1:vid1sku_pricesString12|13sku價格，格式:p1|p2sku_propertiesString100041:150041A1000046:15844|1001:1501A10006:1504sku 屬性，格式:aid:vidAaid1:vid2|aid3:vid3Aaid4:vid4sku_stocksStringsku庫存，格式:s1|s2trade_noString流水號返回結果名稱是否必須示例值描述modifiedString更改時間ware

29、_idlong商品的idcodeString錯誤碼返回示例JSONR據(jù)格式"ware_update_listing_response": "ware id”: 1100000015,"modified": "2012-01-06 11:13:19”, "code": "0"SDK調用示例(java )public JdClient client = new DefaultJdClient(SERVER_URL,”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, &qu

30、ot; 36AB8642CCEF66293AD391EE7E4E95 15“ ，" 0da953632d0a4741beb0bbd096214605” )；WareUpdateRequest wareUpdateRequest = new WareUpdateRequest();wareUpdateRequest.setWareId("1100028130");wareUpdateRequest.setTitle("API商品測試-商品名稱一修改商品");wareUpdateRequest.setLength("11");w

31、areUpdateRequest.setWide("21");wareUpdateRequest.setHigh("31");wareUpdateRequest.setWeight("111");wareUpdateRequest.setMarketPrice("799");wareUpdateRequest.setJdPrice("680");wareUpdateRequest.setNotes(描述 1 修改商品 23123<br />");wareUpdateRequ

32、est.setRate("331");wareUpdateRequest.setPackListing("!裝清單-修改商品");wareUpdateRequest.setService("售后服務一修改商品");wareUpdateRequest.setAttributes("3205:64734|3206:22107");wareUpdateRequest.setSkuProperties("1000000041:150029941A1000000046:150029944|1000000041:15

33、0029941A1000000046:150029943");wareUpdateRequest.setSkuPrices("600|700");wareUpdateRequest.setSkuStocks("100|900");WareUpdateResponse wareUpdateResponse= client.execute(wareUpdateRequest);3.商品上架接口名稱360buy.ware.update.listing功能說明通過api根據(jù)ware_id商品編號 操作商品上架系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述method

34、String是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號返回結果名稱是否必須示例值描

35、述modifiedString更改時間ware_idlong商品的idcodeString錯誤碼返回示例JSONR據(jù)格式"ware_update_listing_response": "ware_id": 1100000015, "modified": "2012-01-06 11:13:19”, "code": "0"SDK調用示例(java )E95public JdClient client = new DefaultJdClient(SERVER_URL,”c7b82199-f

36、26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66293AD391EE7 15“ ，" 0da953632d0a4741beb0bbd096214605” )；WareUpdateListingRequest wareUpdateListingRequest=newWareUpdateListingRequest();wareUpdateListingRequest.setWareId("1100027676");WareUpdateListingResponse res = client.execute(ware

37、UpdateListingRequest);4.商品下架接口名稱360buy.ware.update.delisting功能說明通過api根據(jù)ware_id商品編號 操作商品上架系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatStrin

38、g否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號返回結果名稱是否必須示例值描述modifiedString更改時間ware_idlong商品的idcodeString錯誤碼返回示例JSONR據(jù)格式 "ware update delisting response": H.ware_id": 1100000015, modified": "2012-01-06 11:13:19”, Code":

39、 "0"SDK調用示例（java ）E95public JdClient client = new DefaultJdClient(SERVER_URL,”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66293AD391EE7E 15“ ，" 0da953632d0a4741beb0bbd096214605” )；WareUpdateDelistingRequest wareUpdateDelistingRequest=newWareUpdateDelistingRequest();wareU

40、pdateDelistingRequest.setWareId("1100000022");WareUpdateDelistingResponse res = client.execute(wareUpdateDelistingRequest);5.刪除商品信息接口名稱360buy.ware.delete功能說明通過api根據(jù)ware_id商品編號 刪除商品系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名ti

41、mestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號返回結果名稱是否必須示例值描述createdString創(chuàng)建時間ware_idlong商品的idcodeString錯誤碼返回示例JSONR據(jù)格式"ware_delete_response&qu

42、ot;: "ware_id": 1100000015,"created": "2012-01-06 11:22:15”, "code": "0"SDK調用示例（java ）public JdClient client = new DefaultJdClient(SERVER_URL,”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66293AD391EE7E4E95 15“ ，" 0da953632d0a4741beb0bbd

43、096214605” )；WareDeleteRequest wareDeleteRequest= new WareDeleteRequest();wareDeleteRequest.setWareId("1100000022");WareDeleteResponse res = client.execute(wareDeleteRequest);6.根據(jù)商品ID查詢單個商品的詳細信息接口名稱360buy.ware.get功能說明通過api接口，輸入單個商品id,得到所有相關商品的全部信息系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_

44、tokenString是采用OAuth授權方式為必填參數(shù)_app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值：2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述fieldsString否ware_id,spu_id category_id, created需返回的字段列表?？蛇x值：ware結構體中的所用字段；字段之

45、間用“分隔ware_idString是1100000015商品的id返回結果名稱示例值描述wareWare商品信息codestring返回錯誤code,如果能夠正常返回結果則code=0,否則code!=0Ware結構名稱示例值描述ware_idnumber1100000015商品IDSkusSku1100000015Sku對象信息，Sku對象信息，參見獲取sku信息中的sku對象spu_idString275333spu IDcidvender_idnumbernumber158920032分類ID三級類目ID商家IDshop_idnumber12314店鋪IDware_statusStri

46、ngNEVER_UP商品狀態(tài)：NEVER_UP從未上架， CUSTORMER_DOWN 自主下架 SYSTEM_DOWN系統(tǒng)下架 ON_SALE 在售 AUDIT_AWAIT:待審核 AUDIT_FAIL:審核不通過TitleString京東sop襯衫1商品標題item_numString23424住耳upc_codeString6948807910044UPC編碼transport_idnumber333運費模板online_timeString2011-12-26最后上架時間16:09:29offline_timeString2011-12-26最后下架時間16:14:20attribut

47、esString1001:1501A1006：可選屬性1504descstring商品商品描述producterString生產(chǎn)1商wrapString包裝規(guī)格cubagestring長:寬:高11:21:31pack_listingString包裝清單serviceString售后服務cost_priceString123.13進貨價，精確到2位小數(shù)，單位：元market_priceString123.13市場價，精確到2位小數(shù)，單位：元jd_priceString12.13京東價,精確到2位小數(shù)，單位：兀stock_numnumber10庫存LogoString1650/29f0f69商品

48、的主圖1-30bd-4d52-9041-285d341422ca.jpgCreatorStatusStringnumber路由器Delete錄入人狀態(tài)：Delete:刪除Invalid:無效Valid :有效WeightString10重量，單位：公斤CreatedString2011-11-0415:24:43WARE_WAR由J建時間時間格式：yyyy-MM-ddHH:mm:ssmodifiedString2011-11-0415:34:43WARE_WARE啰改時間時間格式：yyyy-MM-ddHH:mm:ssouter_idStringAf1315外部id,商家設置的外部id返回示例J

49、SONR據(jù)格式 "ware_get_response":"ware ":"attributes":"3767:25944A3768:25945A3769:25950”,"status"：" Delete","transport_id":0,"vender_id":20032,"category_id":1589,"ware_id":1100000015,"spu_id":0,"

50、shop_id":16,"ware_status":"CUSTORMER_DOWN","title":"333","item_num":"null","upc_code":"hahaa”，"online_time":"2011-12-26 16:09:29","offline_time":"2011-12-26 16:14:20","cost_pr

51、ice":"10.00","market_price":"20.00”,"jd_price":"20.00","stock_num”:0,"logo":"1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg","creator":"null","weight":"10.0","created":"20

52、10-07-22 12:01:43”,"modified":"2011-12-30 16:35:43”, "outer_id":"null","skus":"","code":"0"SDK調用示例（java ）public JdClient client = new DefaultJdClient(SERVER_URL,E95”c7b82199-f26d-459e-a4b3-d6f6cec4b869”, " 36AB8642CCEF66

53、293AD391EE715“ ，" 0da953632d0a4741beb0bbd096214605” )；WareGetRequest wareGetRequest= WareGetRequest();wareGetRequest.setWareId(”1100000015”)；wareGetRequest.setFields("”)；WareGetResponseres= client.execute(wareGetRequest);7 .批量獲取商品信息接口名稱360buy.wares.list.get功能說明通過api接口，輸入多個商品id （多個id用逗號分隔），

54、批量得到所有相關商品的 全部信息系統(tǒng)級別輸入?yún)?shù)名稱是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數(shù)app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為 yyyy-MM-ddHH:mm:ss ,例如：2011-06-16 13:23:30。京東 API 服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協(xié)議版本，可選值:2.0.應用級輸入?yún)?shù)名稱是否必須示例值描述fieldsString否ware_id

55、,spu_id category_id, created需返回的字段列表?？蛇x值：ware結構體中的所用字段；字段之間用“分隔ware_idsString是1100000015,1100000016商品的id,用逗號分隔，最多不能超過10個返回結果名稱示例值描述waresList<Ware>商品信息codestring返回錯誤code,如果能夠正常返回結果則code=0,否則code!=0Ware結構名稱示例值描述ware_idnumber1100000015商品IDskusSku1100000015Sku對象信息，參見獲取sku信息中的sku對象spu_idString27533

56、3spu IDcidnumber1589分類ID三級類目IDvender_idnumber20032商家IDshop_idnumber12314店鋪IDware_statusStringNEVER_UP商品狀態(tài)：NEVER_UP從未上架, CUSTORMER_DOWN 自主下架SYSTEM_DOWN系統(tǒng)下架ON_SALE 在售AUDIT_AWAIT:待審核AUDIT_FAIL:審核不通過titleString京東sop襯衫1商品標題item_numString23424住耳upc_codeString6948807910044UPC編碼transport_idnumber333運費模板online_timeString2011-12-26最后上架時間16:09:29offline_timeString2011-12-26最后下架時間16:14:20attribu