京東API商品接口文檔一、 類目API1. 獲取商家類目信息 接口名稱 360buy.warecats.get 功能說明根據商家id獲取商家已經開通的類目。 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值2.0. 應用級輸入參數名稱類型是否必須示例值描述fieldsString是id,fid,status,lev,name,index_id需返回的字段列表。 返回結果名稱類型是否必須示例值描述item_catsList是類目信息codecategory結構名稱類型示例值描述idnumber2323類目idindex_idnumber12314排序（越小越靠前）fidnumber123122父類目idnameString類目名稱Is_parentbooleantrue該類目是否為父類目(即：該類目是否還有子類目)statusstringvalid類目狀態（deleted，unvalid, valid）levnumber1等級(類目分為1、2、3級) 返回示例JSON數據格式 ware_category_search_response: item_cats: name: 高清播放器, id: 1261, status: valid, lev: 3, fid: 794 , name: 面膜面貼, id: 6543, status: valid, lev: 3, fid: 6355 , name: T恤, id: 1349, status: valid, lev: 3, fid: 1342 , total: 3, code: 0 SDK調用示例（java）public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);CategorySearchRequest request = new CategorySearchRequest();CategorySearchResponse response=client.execute(request);2. 獲取類目屬性信息 接口名稱 360buy.ware.get.attribute 功能說明獲取類目下的屬性信息。 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述fieldsString是aid,name,is_key_prop,is_sale_prop,index_id,status,att_type,input_type,is_req,is_fet,is_nav,cid需返回的字段列表。cidnumber是類目idis_key_propboolean否true是否關鍵屬性(true/false)is_sale_propboolean否false是否銷售屬性(true/false)aidnumber否屬性id 返回結果名稱類型是否必須示例值描述attributesList是類目屬性信息attribute結構名稱類型示例值描述aidnumber2323屬性idnamestring12314屬性名is_key_propbooleanfalse關鍵屬性is_sale_propbooleantrue銷售屬性index_idnumber排序(越小越靠前)statusnumber1狀態att_typenumber屬性類型1、關鍵屬性2、不變屬性3、可變屬性4、銷售屬性input_typenumber輸入類型(1、單選， 2、多選3、輸入(最大50個字符)is_reqbooleantrue是否必填is_fetbooleantrue是否篩選is_navbooleantrue是否導航 返回示例JSON數據格式 category_attribute_search_response: attributes: name: 價格, status: valid, input_type: 1, cid: 1575, index_id: 1, aid: 3756, att_type: 3, is_req: false, is_fet: true, is_nav: false , name: 品牌, status: valid, input_type: 1, cid: 1575, index_id: 1, aid: 3755, att_type: 3, is_req: false, is_fet: true, is_nav: false , total: 2, code: 0 SDK調用示例（java）public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);CategoryAttributeSearchRequest request = new CategoryAttributeSearchRequest();request.setCid(4001);CategoryAttributeSearchResponse response=client.execute(request);3. 獲取類目屬性值信息 接口名稱 360buy.ware.get.attvalue 功能說明獲取類目下的屬性值信息。 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述fieldsString是aid,vid,name,status,index_id需返回的字段列表。avsstring是屬性和屬性值 id串，格式例如(pid1;pid2)或(pid1:vid1;pid2:vid2)或(pid1;pid2:vid2) 返回結果名稱類型是否必須示例值描述att_valuesList是類目屬性值信息AttValue結構名稱類型示例值描述aidnumber2323屬性idvidnumber12314屬性值idnamestring屬性值名字statusstringunvalid狀態（deleted，unvalid，valid）index_idnumber排序(越小越靠前) 返回示例JSON數據格式 category_attribute_value_response: att_values: name:0-99, status:valid, index_id:1, aid:3206, vid:22106 , name:秋水之韻, status:valid, 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,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);CategoryAttributeValueSearchRequest request = new CategoryAttributeValueSearchRequest();request.setAvs(8739);CategoryAttributeValueSearchResponse response=client.execute(request);二、 商品API1. 添加商品 接口名稱360buy.ware.add 功能說明新增一個商品 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述cidString是1354類目idshop_categoryString206-208;207-208206(一級)-208(二級);207(一級)-207(一級)店內分類TitleString是標題upc_codeStringupc編碼option_typeString操作類型，現只支持：offsaleitem_numString貨號ProducterString生產廠商WrapString包裝規格LengthString是長WideString是寬HighString是高WeightString是重量cost_priceString進貨價market_priceString是市場價jd_priceString是京東價NotesString是描述ware_imageByte是圖片信息pack_listingString包裝清單ServiceString售后服務stock_numString是庫存數AttributesString是3205:22101|3205:22102商品屬性列表,格式:pid:vid;pid:vid|pid1:vid1;pid1:vid1sku_pricesString12|13sku 價格,格式:p1|p2sku_propertiesString100041:1500411000046:15844|1001:150110006:1504sku 屬性,格式:aid:vidaid1:vid2|aid3:vid3aid4:vid4sku_stocksStringsku 庫存, 格式:s1|s2trade_noString流水號 返回結果名稱類型是否必須示例值描述createdString 更改時間ware_idlong商品的idcodeString錯誤碼 返回示例JSON數據格式 ware_update_listing_response: ware_id: 1100000015, created: 2012-01-06 11:13:19, code: 0 SDK調用示例（java）public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareAddRequest wareAddRequest= new WareAddRequest();wareAddRequest.setCategoryId(1354); /類目 服飾鞋帽 女裝 襯衫 (1354) 藥品 感冒用藥 風寒風熱(6359)wareAddRequest.setWareImage(imageFactory(); /主圖wareAddRequest.setTitle(API商品測試-商品名稱1111);wareAddRequest.setLength(1);wareAddRequest.setWide(2);wareAddRequest.setHigh(3);wareAddRequest.setWeight(11);wareAddRequest.setMarketPrice(500); /市場價wareAddRequest.setJdPrice(444); /京東價wareAddRequest.setNotes(描述123123);/描述wareAddRequest.setPackListing(包裝清單); /包裝清單wareAddRequest.setService(售后服務); /售后服務wareAddRequest.setStockNum(100);wareAddRequest.setAttributes(3205:64734|3206:22107); wareAddRequest.setSkuProperties(1000000041:1500299411000000046:150029944|1000000041:1500299411000000046:150029943);wareAddRequest.setSkuPrices(300|500);wareAddRequest.setSkuStocks(10|90);2. 修改商品 接口名稱360buy.ware.update.listing 功能說明 通過api 根據ware_id 商品編號 操作商品上架 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述ware_idString是1354商品idshop_categoryString206-208;207-208206(一級)-208(二級);207(一級)-207(一級)店內分類titleString是標題upc_codeStringupc編碼option_typeString操作類型，現只支持：offsaleitem_numString貨號producterString生產廠商wrapString包裝規格lengthString是長wideString是寬highString是高weightString是重量cost_priceString進貨價market_priceString是市場價jd_priceString是京東價notesString是描述pack_listingString包裝清單ServiceString售后服務attributesString是3205:22101|3205:22102商品屬性列表,格式:pid:vid;pid:vid|pid1:vid1;pid1:vid1sku_pricesString12|13sku 價格,格式:p1|p2sku_propertiesString100041:1500411000046:15844|1001:150110006:1504sku 屬性,格式:aid:vidaid1:vid2|aid3:vid3aid4:vid4sku_stocksStringsku 庫存, 格式:s1|s2trade_noString流水號 返回結果名稱類型是否必須示例值描述modifiedString 更改時間ware_idlong商品的idcodeString錯誤碼 返回示例JSON數據格式 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,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareUpdateRequest wareUpdateRequest = new WareUpdateRequest();wareUpdateRequest.setWareId(1100028130); wareUpdateRequest.setTitle(API商品測試-商品名稱-修改商品);wareUpdateRequest.setLength(11);wareUpdateRequest.setWide(21);wareUpdateRequest.setHigh(31);wareUpdateRequest.setWeight(111);wareUpdateRequest.setMarketPrice(799); wareUpdateRequest.setJdPrice(680); wareUpdateRequest.setNotes(描述1修改商品23123); wareUpdateRequest.setRate(331); wareUpdateRequest.setPackListing(包裝清單-修改商品); wareUpdateRequest.setService(售后服務-修改商品); wareUpdateRequest.setAttributes(3205:64734|3206:22107);wareUpdateRequest.setSkuProperties(1000000041:1500299411000000046:150029944|1000000041:1500299411000000046:150029943);wareUpdateRequest.setSkuPrices(600|700);wareUpdateRequest.setSkuStocks(100|900);WareUpdateResponse wareUpdateResponse= client.execute(wareUpdateRequest);3. 商品上架 接口名稱360buy.ware.update.listing 功能說明 通過api 根據ware_id 商品編號 操作商品上架 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號 返回結果名稱類型是否必須示例值描述modifiedString 更改時間ware_idlong商品的idcodeString錯誤碼 返回示例JSON數據格式 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,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareUpdateListingRequest wareUpdateListingRequest=new WareUpdateListingRequest();wareUpdateListingRequest.setWareId(1100027676);WareUpdateListingResponse res = client.execute(wareUpdateListingRequest);4. 商品下架 接口名稱360buy.ware.update.delisting 功能說明 通過api 根據ware_id 商品編號 操作商品上架 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號 返回結果名稱類型是否必須示例值描述modifiedString 更改時間ware_idlong商品的idcodeString錯誤碼 返回示例JSON數據格式 ware_update_delisting_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,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareUpdateDelistingRequest wareUpdateDelistingRequest=new WareUpdateDelistingRequest();wareUpdateDelistingRequest.setWareId(1100000022);WareUpdateDelistingResponse res = client.execute(wareUpdateDelistingRequest);5. 刪除商品信息 接口名稱360buy.ware.delete 功能說明 通過api 根據ware_id 商品編號 刪除商品 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號 返回結果名稱類型是否必須示例值描述createdString 創建時間ware_idlong商品的idcodeString錯誤碼 返回示例JSON數據格式 ware_delete_response: 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,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareDeleteRequest wareDeleteRequest= new WareDeleteRequest();wareDeleteRequest.setWareId(1100000022);WareDeleteResponse res = client.execute(wareDeleteRequest);6. 根據商品ID查詢單個商品的詳細信息 接口名稱360buy.ware.get 功能說明 通過api接口，輸入單個商品id，得到所有相關商品的全部信息 系統級別輸入參數名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權方式為必填參數app_keyString是應用的app_keysignString是簽名timestampString是時間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務端允許客戶端請求時間誤差為6分鐘formatString否暫時只支持jsonvString是API協議版本，可選值:2.0. 應用級輸入參數名稱類型是否必須示例值描述fieldsString否ware_id,spu_idcategory_id,created需返回的字段列表。可選值：ware結構體中的所有字段；字段之間用“,”分隔ware_idString是1100000015商品的id 返回結果名稱類型示例值描述wareWare商品信息codestring返回錯誤code，如果能夠正常返回結果則code=0，否則code!=0 Ware結構名稱類型示例值描述ware_idnumber1100000015商品IDSkusSku1100000015Sku對象信息, Sku對象信息,參見獲取sku信息中的sku對象spu_idString275333spu IDcidnumber1589分類ID 三級類目IDvender_idnumber20032商家IDshop_idnumber12314店鋪IDware_statusStringNEVER_UP商品狀態: NEVER_UP:從未上架,CUSTORMER_DOWN:自主下架SYSTEM_DOWN:系統下架ON_SALE:在售AUDIT_AWAIT: 待審核AUDIT_FAIL: 審核不通過TitleString京東sop襯衫1商品標題item_numString23424貨號upc_codeString6948807910044UPC編碼transport_idnumber333運費模板online_timeString2011-12-26 16:09:29最后上架時間offline_timeString2011-12-26 16:14:20最后下架時間attributesString1001:15011006:1504可選屬性descstring商品商品描述producterString生產廠商wrapString包裝規格cubagestring長:寬:高11:21:31pack_listingString包裝清單serviceString售后服務cost_priceString123.13進貨價, 精確到2位小數，單位:元market_priceString123.13市場價, 精確到2位小數，單位:元jd_priceString12.13京東價,精確到2位小數，單位:元stock_numnumber10庫存LogoString1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg商品的主圖CreatorString路由器錄入人StatusnumberDelete狀態：Delete:刪除Invalid:無效Valid :有效WeightString10重量,單位:公斤CreatedString2011-11-04 15:24:43WARE_WARE創建時間時間格式：yyyy-MM-ddHH:mm:ssmodifiedString2011-11-04 15:34:43WARE_WARE修改時間時間格式：yyyy-MM-ddHH:mm:ssouter_idStringAf1315外部id,商家設置的外部id 返回示例JSON數據格式 ware_get_response: ware : attributes:3767:259443768:259453769:25950,status: Delete,transport_id:0,vender_id:20032,category_id:1589,ware_id:1100000015,spu_id:0,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_price: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:2010-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,c7b82199-f26d-459e-a4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareGetRequest wareGetRequest= WareGetRequest();wareGetRequest.setWareId(1100000015);wareGetRequest.setFields();WareGetResponseres= client.execute(wareGetRequest);7. 批量獲取商品信息 接口名稱360buy.wares.list.get 功能說明 通過api接口，輸入多個商品id（多個id用逗號分隔），批量得到所有相關商品的全部信息 系統級別輸入參數名稱類型是否必須描述methodString是API接口