API 接口doc文档20120523.doc

京东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接口