技术文档

服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

供应商服务

京东云服务

【价格及促销】接口导航

1. 根据SKUID获取商品价格

2. 获取商品促销信息的接口

1. 根据SKUID获取商品价格

接口名称：

jingdong.ware.price.get

应用场景：

适用于无线买家应用及网站应用

API用户授权类型：

不需要

系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	否	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

应用级输入参数

名称

类型

是否必须

示例值

描述

sku_id

String

是

J_100012

商品ID

SKU编号前需加“J_”，否则无法正确返回。

返回结果

名称	类型	示例值	描述
price_changes	PriceChange[ ]

price_changes属性

名称	类型	是否必须	示例值	描述
sku_id	String	否	J_100012	商品编号
price	String	否	66.00	商品价格
market_price	String	否		市场价

返回示例

JSON数据格式

{
"jingdong_ware_price_get_response": {
"price_changes": [
{
"price": "66.00",
"market_price": "",
"sku_id": "J_100012"
}
]
}
}

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePriceGetRequest request=new WarePriceGetRequest();
request.setSkuId( "jingdong" );
WarePriceGetResponse response=client.execute(request);

2. 获取商品促销信息的接口

接口名称：

jingdong.ware.promotionInfo.get

应用场景：

适用于无限买家应用及网站应用

API用户授权类型：

不需要

系统级别输入参数

名称	类型	是否必须	描述
method	String	是	API接口名称
access_token	String	否	采用OAuth授权方式为必填参数
app_key	String	是	应用的app_key
sign	String	是	签名
timestamp	String	是	时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟
format	String	否	暂时只支持json
v	String	否	API协议版本，可选值:2.0

应用级输入参数

名称	类型	是否必须	示例值	描述
skuId	String	是		商品编号
webSite	Number	是		站点,1-京东、2-千寻、3-ept海外购
origin	Number	是		来源（默认为1）,1-网站交易、2-手机包括ipad

返回结果

名称	类型	示例值	描述
promoInfoResponse	AdwordResponse		促销信息返回结构

adwordResponse属性

名称	类型	是否必须	示例值	描述
skuId	String	否		商品编号
promotionInfoList	PromotionInfo[]	否		促销信息集合

promotionInfoList属性

名称	类型	是否必须	示例值	描述
promoId	String	否		促销编号
promoType	Number	否		促销类型
extType	Number	否		单品扩展类型
fullRefundType	Number	否		满返满赠扩展类型
userLevel	Number	否		用户级别
minNum	Number	否		最小购买数
maxNum	Number	否		最大购买数
limitUserType	Number	否		是否为限购，4是限购
price	String	否		京东价 (只有会员级别促销时，才有price返回值，如：铁牌及以上会员专享)
discount	String	否		直降直降
reward	String	否		返现
addMoney	String	否		加价购所加的钱
needMondey	String	否		参加满返满赠所需的金额
needNum	Number	否		参加满返满赠所需的商品数量
deliverNum	Number	否		参加满返满赠减N件最低价的阶梯数
topMoney	String	否		每满返的封顶价
percent	Number	否		参加满返促销的返现百分比
rebate	Number	否		折扣
haveFullRefundGifts	Boolean	否		是满赠还是满减促销
score	Number	否		积分
promoEndTime	Number	否		促销结束时间
adwordCouponList	AdwordCoupon[]	否		券集合
adwordGiftSkuList	AdwordGiftSku[]	否		赠品集合

券集合adwordCouponList属性

名称	类型	是否必须	示例值	描述
type	Number	否		券类型
key	String	否		限品类不为空，非限品类为空
couponQouta	Number	否		券值大小

赠品集合adwordGiftSkuList 属性

名称	类型	是否必须	示例值	描述
skuId	String	否		赠品编号
imagePath	String	否		赠品图片路径
name	String	否		赠品名称
number	Number	否		赠品数量
giftType	Number	否		赠品类型，1-附件、2-普通赠品

返回示例

JSON数据格式

{
"jingdong_ware_promotionInfo_get_response": {
"promoInfoResponse": {
"promotionInfoList": [
{
"promoId": "",
"percent": "",
"extType": "",
"adwordGiftSkuList": [
{
"giftType": "",
"imagePath": "",
"name": "",
"skuId": "",
"number": "",
"giftState": ""
}
],
"reward": "",
"fullRefundType": "",
"haveFullRefundGifts": "",
"adwordCouponList": [
{
"couponQouta": "",
"type": "",
"key": ""
}
],
"topMoney": "",
"promoEndTime": "",
"score": "",
"minNum": "",
"needNum": "",
"needMondey": "",
"discount": "",
"price": "",
"userLevel": "",
"rebate": "",
"addMoney": "",
"maxNum": "",
"promoType": "",
"limitUserType": "",
"deliverNum": ""
}
],
"skuId": ""
}
}
}

SDK调用示例（java）

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionInfoGetRequest request=new WarePromotionInfoGetRequest();
request.setSkuId( "jingdong" );
request.setWebSite( 123 );
request.setOrigin( 123 );
WarePromotionInfoGetResponse response=client.execute(request);