API 接口doc文檔20120523.doc

京東API商品接口文檔一、 類目API1. 獲取商家類目信息 接口名稱 360buy.warecats.get 功能說明根據(jù)商家id獲取商家已經(jīng)開通的類目。 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述fieldsString是id,fid,status,lev,name,index_id需返回的字段列表。 返回結(jié)果名稱類型是否必須示例值描述item_catsList是類目信息codecategory結(jié)構(gòu)名稱類型示例值描述idnumber2323類目idindex_idnumber12314排序（越小越靠前）fidnumber123122父類目idnameString類目名稱Is_parentbooleantrue該類目是否為父類目(即：該類目是否還有子類目)statusstringvalid類目狀態(tài)（deleted，unvalid, valid）levnumber1等級(jí)(類目分為1、2、3級(jí)) 返回示例JSON數(shù)據(jù)格式 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調(diào)用示例（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 功能說明獲取類目下的屬性信息。 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?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,cid需返回的字段列表。cidnumber是類目idis_key_propboolean否true是否關(guān)鍵屬性(true/false)is_sale_propboolean否false是否銷售屬性(true/false)aidnumber否屬性id 返回結(jié)果名稱類型是否必須示例值描述attributesList是類目屬性信息attribute結(jié)構(gòu)名稱類型示例值描述aidnumber2323屬性idnamestring12314屬性名is_key_propbooleanfalse關(guān)鍵屬性is_sale_propbooleantrue銷售屬性index_idnumber排序(越小越靠前)statusnumber1狀態(tài)att_typenumber屬性類型1、關(guān)鍵屬性2、不變屬性3、可變屬性4、銷售屬性input_typenumber輸入類型(1、單選， 2、多選3、輸入(最大50個(gè)字符)is_reqbooleantrue是否必填is_fetbooleantrue是否篩選is_navbooleantrue是否導(dǎo)航 返回示例JSON數(shù)據(jù)格式 category_attribute_search_response: attributes: name: 價(jià)格, 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調(diào)用示例（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 功能說明獲取類目下的屬性值信息。 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述fieldsString是aid,vid,name,status,index_id需返回的字段列表。avsstring是屬性和屬性值 id串，格式例如(pid1;pid2)或(pid1:vid1;pid2:vid2)或(pid1;pid2:vid2) 返回結(jié)果名稱類型是否必須示例值描述att_valuesList是類目屬性值信息AttValue結(jié)構(gòu)名稱類型示例值描述aidnumber2323屬性idvidnumber12314屬性值idnamestring屬性值名字statusstringunvalid狀態(tài)（deleted，unvalid，valid）index_idnumber排序(越小越靠前) 返回示例JSON數(shù)據(jù)格式 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調(diào)用示例（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 功能說明新增一個(gè)商品 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述cidString是1354類目idshop_categoryString206-208;207-208206(一級(jí))-208(二級(jí));207(一級(jí))-207(一級(jí))店內(nèi)分類TitleString是標(biāo)題upc_codeStringupc編碼option_typeString操作類型，現(xiàn)只支持：offsaleitem_numString貨號(hào)ProducterString生產(chǎn)廠商WrapString包裝規(guī)格LengthString是長(zhǎng)WideString是寬HighString是高WeightString是重量cost_priceString進(jìn)貨價(jià)market_priceString是市場(chǎng)價(jià)jd_priceString是京東價(jià)NotesString是描述ware_imageByte是圖片信息pack_listingString包裝清單ServiceString售后服務(wù)stock_numString是庫(kù)存數(shù)AttributesString是3205:22101|3205:22102商品屬性列表,格式:pid:vid;pid:vid|pid1:vid1;pid1:vid1sku_pricesString12|13sku 價(jià)格,格式:p1|p2sku_propertiesString100041:1500411000046:15844|1001:150110006:1504sku 屬性,格式:aid:vidaid1:vid2|aid3:vid3aid4:vid4sku_stocksStringsku 庫(kù)存, 格式:s1|s2trade_noString流水號(hào) 返回結(jié)果名稱類型是否必須示例值描述createdString 更改時(shí)間ware_idlong商品的idcodeString錯(cuò)誤碼 返回示例JSON數(shù)據(jù)格式 ware_update_listing_response: ware_id: 1100000015, created: 2012-01-06 11:13:19, code: 0 SDK調(diào)用示例（java）public JdClient client = new DefaultJdClient(SERVER_URL,c7b82199-f26d-459e-a4b3-d6f6cec4b869,”36AB8642CCEF66293AD391EE7E4E9515”,”0da953632d0a4741beb0bbd096214605”);WareAddRequest wareAddRequest= new WareAddRequest();wareAddRequest.setCategoryId(1354); /類目 服飾鞋帽 女裝 襯衫 (1354) 藥品 感冒用藥 風(fēng)寒風(fēng)熱(6359)wareAddRequest.setWareImage(imageFactory(); /主圖wareAddRequest.setTitle(API商品測(cè)試-商品名稱1111);wareAddRequest.setLength(1);wareAddRequest.setWide(2);wareAddRequest.setHigh(3);wareAddRequest.setWeight(11);wareAddRequest.setMarketPrice(500); /市場(chǎng)價(jià)wareAddRequest.setJdPrice(444); /京東價(jià)wareAddRequest.setNotes(描述123123);/描述wareAddRequest.setPackListing(包裝清單); /包裝清單wareAddRequest.setService(售后服務(wù)); /售后服務(wù)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 根據(jù)ware_id 商品編號(hào) 操作商品上架 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述ware_idString是1354商品idshop_categoryString206-208;207-208206(一級(jí))-208(二級(jí));207(一級(jí))-207(一級(jí))店內(nèi)分類titleString是標(biāo)題upc_codeStringupc編碼option_typeString操作類型，現(xiàn)只支持：offsaleitem_numString貨號(hào)producterString生產(chǎn)廠商wrapString包裝規(guī)格lengthString是長(zhǎng)wideString是寬highString是高weightString是重量cost_priceString進(jìn)貨價(jià)market_priceString是市場(chǎng)價(jià)jd_priceString是京東價(jià)notesString是描述pack_listingString包裝清單ServiceString售后服務(wù)attributesString是3205:22101|3205:22102商品屬性列表,格式:pid:vid;pid:vid|pid1:vid1;pid1:vid1sku_pricesString12|13sku 價(jià)格,格式:p1|p2sku_propertiesString100041:1500411000046:15844|1001:150110006:1504sku 屬性,格式:aid:vidaid1:vid2|aid3:vid3aid4:vid4sku_stocksStringsku 庫(kù)存, 格式:s1|s2trade_noString流水號(hào) 返回結(jié)果名稱類型是否必須示例值描述modifiedString 更改時(shí)間ware_idlong商品的idcodeString錯(cuò)誤碼 返回示例JSON數(shù)據(jù)格式 ware_update_listing_response: ware_id: 1100000015, modified: 2012-01-06 11:13:19, code: 0 SDK調(diào)用示例（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商品測(cè)試-商品名稱-修改商品);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(售后服務(wù)-修改商品); 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 根據(jù)ware_id 商品編號(hào) 操作商品上架 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號(hào) 返回結(jié)果名稱類型是否必須示例值描述modifiedString 更改時(shí)間ware_idlong商品的idcodeString錯(cuò)誤碼 返回示例JSON數(shù)據(jù)格式 ware_update_listing_response: ware_id: 1100000015, modified: 2012-01-06 11:13:19, code: 0 SDK調(diào)用示例（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 根據(jù)ware_id 商品編號(hào) 操作商品上架 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號(hào) 返回結(jié)果名稱類型是否必須示例值描述modifiedString 更改時(shí)間ware_idlong商品的idcodeString錯(cuò)誤碼 返回示例JSON數(shù)據(jù)格式 ware_update_delisting_response: ware_id: 1100000015, modified: 2012-01-06 11:13:19, code: 0 SDK調(diào)用示例（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 根據(jù)ware_id 商品編號(hào) 刪除商品 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述ware_idString是1100000015商品的idtrade_nolong流水號(hào) 返回結(jié)果名稱類型是否必須示例值描述createdString 創(chuàng)建時(shí)間ware_idlong商品的idcodeString錯(cuò)誤碼 返回示例JSON數(shù)據(jù)格式 ware_delete_response: ware_id: 1100000015, created: 2012-01-06 11:22:15, code: 0 SDK調(diào)用示例（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. 根據(jù)商品ID查詢單個(gè)商品的詳細(xì)信息 接口名稱360buy.ware.get 功能說明 通過api接口，輸入單個(gè)商品id，得到所有相關(guān)商品的全部信息 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口名稱access_tokenString是采用OAuth授權(quán)方式為必填參數(shù)app_keyString是應(yīng)用的app_keysignString是簽名timestampString是時(shí)間戳，格式為yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京東API服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘formatString否暫時(shí)只支持jsonvString是API協(xié)議版本，可選值:2.0. 應(yīng)用級(jí)輸入?yún)?shù)名稱類型是否必須示例值描述fieldsString否ware_id,spu_idcategory_id,created需返回的字段列表?？蛇x值：ware結(jié)構(gòu)體中的所有字段；字段之間用“,”分隔ware_idString是1100000015商品的id 返回結(jié)果名稱類型示例值描述wareWare商品信息codestring返回錯(cuò)誤code，如果能夠正常返回結(jié)果則code=0，否則code!=0 Ware結(jié)構(gòu)名稱類型示例值描述ware_idnumber1100000015商品IDSkusSku1100000015Sku對(duì)象信息, Sku對(duì)象信息,參見獲取sku信息中的sku對(duì)象spu_idString275333spu IDcidnumber1589分類ID 三級(jí)類目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商品標(biāo)題item_numString23424貨號(hào)upc_codeString6948807910044UPC編碼transport_idnumber333運(yùn)費(fèi)模板online_timeString2011-12-26 16:09:29最后上架時(shí)間offline_timeString2011-12-26 16:14:20最后下架時(shí)間attributesString1001:15011006:1504可選屬性descstring商品商品描述producterString生產(chǎn)廠商wrapString包裝規(guī)格cubagestring長(zhǎng):寬:高11:21:31pack_listingString包裝清單serviceString售后服務(wù)cost_priceString123.13進(jìn)貨價(jià), 精確到2位小數(shù)，單位:元market_priceString123.13市場(chǎng)價(jià), 精確到2位小數(shù)，單位:元jd_priceString12.13京東價(jià),精確到2位小數(shù)，單位:元stock_numnumber10庫(kù)存LogoString1650/29f0f691-30bd-4d52-9041-285d341422ca.jpg商品的主圖CreatorString路由器錄入人StatusnumberDelete狀態(tài)：Delete:刪除Invalid:無效Valid :有效WeightString10重量,單位:公斤CreatedString2011-11-04 15:24:43WARE_WARE創(chuàng)建時(shí)間時(shí)間格式：yyyy-MM-ddHH:mm:ssmodifiedString2011-11-04 15:34:43WARE_WARE修改時(shí)間時(shí)間格式：yyyy-MM-ddHH:mm:ssouter_idStringAf1315外部id,商家設(shè)置的外部id 返回示例JSON數(shù)據(jù)格式 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調(diào)用示例（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接口，輸入多個(gè)商品id（多個(gè)id用逗號(hào)分隔），批量得到所有相關(guān)商品的全部信息 系統(tǒng)級(jí)別輸入?yún)?shù)名稱類型是否必須描述methodString是API接口