API接口doc文档20120523

1、京东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否暂时只支持jsonvStrin

2、g是API协议版本，可选值 2.0.应用级输入参数名称是否必须示例值描述fieldsString是id,fid,status,lev,name,index_id需返回的字段列表。返回结果名称是否必须示例值描述item_catsList<category>是类目信息codecategory 结构名称示例值描述idnumber2323类目idindex_idnumber12314排序（越小越靠前）fidnumber123122父类目idnameString类目名称Is_parentbooleantrue该类目是否为父类目（即：该类目是否还 有子类目）statusstringvalid类

3、目状态(deleted , unvalid, valid )levnumber1等级（类目分为1、2、3级）返回示例JSONR据格式"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功能说明获取类目下的属性信息。系统级别输入参数名称是否必须描述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

7、.应用级输入参数名称是否必须示例值描述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状态att_typenumber属性类型1、关键属性2、不变属性3、可变属性4、销售属性input_typenumber输入类型（1、单选，2、多选3、输入（最大50个字符）is_reqbooleantrue是否必填trueis fetboolean是否筛选is_navbooleantrue是否导航返回示例J

9、SONR据格式"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功能说明获取类目下的属性值信息。系统级别输入参数名称是否必须描述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.应用级输入参数名称是否必须示例值描述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状态(deleted , unvalid , valid )index

15、_idnumber排序(越小越靠前)返回示例JSONR据格式("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功能说明新增一个商品系统级别输入参数名称是否必须描述methodString是API接口名称access_tokenS

18、tring是采用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（一级）

19、店内分类TitleString是标题upc_codeStringupc编码option_typeString操作类型，现只支持：offsaleitem_numString货号ProducterString生产1商WrapString包装规格LengthString是长WideString是宽HighString是高WeightString是cost_priceString进货价market_priceString是市场价jd_priceString是京东价NotesString是描述ware_imageByte口是图片信息pack_listingString包装清单ServiceString售

20、后服务stock_numString是库存数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据格式("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根据ware_id商品编号 操作商品上架系统级别输入参数名称是否必须描述methodString是API接口名称access_tokenStrin

26、g是采用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（一级）

27、店内分类titleString是标题upc_codeStringupc编码option_typeString操作类型，现只支持：offsaleitem_numString货号producterString生产1商wrapString包装规格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据格式"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根据ware_id商品编号 操作商品上架系统级别输入参数名称是否必须描述method

34、String是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流水号返回结果名称是否必须示例值描

35、述modifiedString更改时间ware_idlong商品的idcodeString错误码返回示例JSONR据格式"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根据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分钟formatStrin

38、g否暂时只支持jsonvString是API协议版本，可选值:2.0.应用级输入参数名称是否必须示例值描述ware_idString是1100000015商品的idtrade_nolong流水号返回结果名称是否必须示例值描述modifiedString更改时间ware_idlong商品的idcodeString错误码返回示例JSONR据格式 "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根据ware_id商品编号 删除商品系统级别输入参数名称是否必须描述methodString是API接口名称access_tokenString是采用OAuth授权方式为必填参数app_keyString是应用的app_keysignString是签名ti

41、mestampString是时间戳，格式为 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错误码返回示例JSONR据格式"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.根据商品ID查询单个商品的详细信息接口名称360buy.ware.get功能说明通过api接口，输入单个商品id,得到所有相关商品的全部信息系统级别输入参数名称是否必须描述methodString是API接口名称access_

44、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_id category_id, created需返回的字段列表。可选值：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商品状态：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:29offline_timeString2011-12-26最后下架时间16:14:20attribut

47、esString1001:1501A1006：可选属性1504descstring商品商品描述producterString生产1商wrapString包装规格cubagestring长:宽:高11:21:31pack_listingString包装清单serviceString售后服务cost_priceString123.13进货价，精确到2位小数，单位：元market_priceString123.13市场价，精确到2位小数，单位：元jd_priceString12.13京东价,精确到2位小数，单位：兀stock_numnumber10库存LogoString1650/29f0f69商品

48、的主图1-30bd-4d52-9041-285d341422ca.jpgCreatorStatusStringnumber路由器Delete录入人状态：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据格式 "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、批量得到所有相关商品的 全部信息系统级别输入参数名称是否必须描述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

55、,spu_id category_id, created需返回的字段列表。可选值：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商品状态：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:29offline_timeString2011-12-26最后下架时间16:14:20attribu