服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【移动商城】接口导航


1. 获得京东移动推荐的首页轮播图促销列表

2. 获得京东移动推荐首页轮播促销活动详情
3. 获得移动端的促销专场列表4. 根据移动端某分类获得对应的促销专场活动列表
5. 根据促销专场id获得专场促销活动列表6. 根据促销活动id获得促销活动商品列表
7. 根据三级类目获取类目下推荐商品列表
8. 获取全部逛的促销频道（停用）
9. 获取逛的女士频道的促销商品列表（停用）

10. 获取逛的男士频道的促销商品列表（停用）


1.获得京东移动推荐的首页轮播图促销列表
接口名称
jingdong.ware.promotion.indexactivity.list.get

接口应用场景
无线应用 网站应用

API用户授权类型
需要

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

应用级输入参数

名称 类型 是否必须 示例值 描述
client  String  是 apple  客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
activityInfoList  ActivityList 
首页轮播图列表 

ActivityList属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
activityList  Activit[]  否
首页轮播图列表详情集合列表 

activityList属性

名称 类型 是否必须 示例值 描述
activity  Activit  否
首页轮播图列表对象 

activity属性

名称 类型 是否必须 示例值 描述
activityId  Number  否
活动id 
horizontalImag  String  否
横板图 
sortNo  String  否
排序的号码 
title  String  否
标题 
type  String  否
0：普通活动图，1：专题列表的活动图 

返回示例

JSON数据格式

{
    "jingdong_ware_promotion_indexactivity_list_get_response": {
        "activityInfoList": {
            "resultCode": "",
            "activityList": [
                {
                    "activity": {
                        "activityId": "",
                        "title": "",
                        "horizontalImag": "",
                        "sortNo": "",
                        "type": ""
                    }
                }
            ]
        }
    }

}


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionIndexactivityListGetRequest request=new WarePromotionIndexactivityListGetRequest();
request.setClient( "jingdong" );
WarePromotionIndexactivityListGetResponse response=client.execute(request);

2.获得京东移动推荐首页轮播促销活动详情
接口名称
jingdong.ware.promotion.indexactivity.get
接口应用场景
无线应用 网站应用

API用户授权类型
不需要

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

应用级输入参数

名称 类型 是否必须 示例值 描述
activityId  Number  是 2250  焦点详情编号 
page  Number  是 1  页码 
pageSize  Number  是 10  分页大小 
client  String  是 apple  客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
activityProductsList  ActivityProductsList 

ActivityProductsList属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
totalCount  Number  否
总记录数 
couponStatus  Number  否

page  Number  否

couponURL  String  否

roleIds  String  否

title  String  否

promotionDetail  String  否

horizontalImag  String  否

activityProducts  WareInfo[]  否

WareInfo属性

名称 类型 是否必须 示例值 描述
adWord  String  否
广告词 
isBook  Boolean  否
是否为图书 
canFreeRead  Boolean  否
是否免费阅读 
endRemainTime  String  否
秒杀离结束时间 
imageUrl  String  否
商品图片url 
jdPrice  Number  否
京东价 
martPrice  Number  否
市场价 
startRemainTime  String  否
秒杀离开始时间 
skuId  String  否
商品编号 
wareName  String  否
商品名称 

返回示例

JSON数据格式

{
    "jingdong_ware_promotion_indexactivity_get_response": {
        "activityProductsList": {
            "activityProducts": [
                {
                    "wareName": "",
                    "martPrice": "",
                    "startRemainTime": "",
                    "imageUrl": "",
                    "adWord": "",
                    "skuId": "",
                    "jdPrice": "",
                    "endRemainTime": "",
                    "canFreeRead": "",
                    "isBook": ""
                }
            ],
            "title": "",
            "page": "",
            "couponStatus": "",
            "totalCount": "",
            "couponURL": "",
            "horizontalImag": "",
            "promotionDetail": "",
            "resultCode": "",
            "roleIds": ""
        }
    }

}


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionIndexactivityGetRequest request=new WarePromotionIndexactivityGetRequest();
request.setActivityId( 123 );
request.setPage( 123 );
request.setPageSize( 123 );
request.setClient( "jingdong" );
WarePromotionIndexactivityGetResponse response=client.execute(request);

3.获得移动端的促销专场列表
接口名称

jingdong.ware.promotions.list.get


接口应用场景

无线应用 网站应用


API用户授权类型
不需要


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

应用级输入参数

名称 类型 是否必须 示例值 描述
client  String  是 apple  客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
cmsPromotionsList  CmsPromotionsList 

CmsPromotionsList属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
cmsPromotionsAll  CmsPromotions[]  否

CmsPromotions属性

名称 类型 是否必须 示例值 描述
catelogyId  Number  否
分类编号 
imageUrl  String  否
促销专场图片地址 
promitionInfo  String  否
促销分类名 
promotionId  String  否
促销分类编号 
promotionName  String  否
促销专场名称 

返回示例

JSON数据格式

{
    "jingdong_ware_promotions_list_get_response": {
        "cmsPromotionsList": {
            "cmsPromotionsAll": [
                {
                    "promotionId": "",
                    "promitionInfo": "",
                    "imageUrl": "",
                    "promotionName": "",
                    "catelogyId": ""
                }
            ],
            "resultCode": ""
        }
    }
}

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionsListGetRequest request=new WarePromotionsListGetRequest();
request.setClient( "jingdong" );
WarePromotionsListGetResponse response=client.execute(request);


4.根据移动端某分类获得对应的促销专场活动列表
接口名称

jingdong.ware.promotions.catelogyidlist.get


接口应用场景

无线应用 网站应用


API用户授权类型

不需要


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

应用级输入参数

名称 类型 是否必须 示例值 描述
level  Number  是 1  一级类目，目前默认值为:1，此参数待扩展 
catelogyId  Number  是 1713  分类id 
client  String  是 apple  客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
cmsPromotionsByCatelogyIdList  CmsPromotionsByCatelogyIdList 


CmsPromotionsByCatelogyIdList属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
cmsPromotionsList  CmsPromotions[]  否

CmsPromotions属性

名称 类型 是否必须 示例值 描述
catelogyId  Number  否   分类编号 
imageUrl  String  否   促销专场图片地址 
promitionInfo  String  否   促销分类名 
promotionId  String  否   促销分类编号 
promotionName  String  否   促销专场名称 

返回示例

JSON数据格式

{
    "jingdong_ware_promotions_catelogyidlist_get_response": {
        "cmsPromotionsByCatelogyIdList": {
            "cmsPromotionsList": [
                {
                    "promotionId": "",
                    "promitionInfo": "",
                    "imageUrl": "",
                    "promotionName": "",
                    "catelogyId": ""
                }
            ],
            "resultCode": ""
        }
    }
}


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionsCatelogyidlistGetRequest request=new WarePromotionsCatelogyidlistGetRequest();
request.setLevel( 123 );
request.setCatelogyId( 123 );
request.setClient( "jingdong" );
WarePromotionsCatelogyidlistGetResponse response=client.execute(request);

5.根据促销专场id获得专场促销活动列表
接口名称
jingdong.ware.promotion.activities.list.get
 
接口应用场景
无线应用 网站应用

API用户授权类型
不需要

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

应用级输入参数

名称 类型 是否必须 示例值 描述
promotionsId  Number  是 14  促销编号 
page  Number  是 1  页码 
pageSize  Number  是 10  分页大小 
client  String  是 apple  客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
cmsActivityList  CmsActivityList 

CmsActivityList 属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
totalCount  Number  否
总记录数 
cmsActivityList  CmsActivity[]  否

CmsActivity属性

名称 类型 是否必须 示例值 描述
cmsActivity  CmsActivity  否
促销活动列表 

CmsActivity属性

名称 类型 是否必须 示例值 描述
activityId  Number  否
活动id 
catelogyId  Number  否
分类id 
content  String  否
活动内容描述 
endDate  String  否
活动结束时间 
imageUrl  String  否
活动图片地址 
startDate  String  否
活动开始时间 
status  String  否
活动状态 
title  String  否
活动标题 

返回示例

JSON数据格式

{
    "jingdong_ware_promotion_activities_list_get_response": {
        "cmsActivityList": {
            "cmsActivityLists": [
                {
                    "cmsActivity": {
                        "content": "",
                        "activityId": "",
                        "startDate": "",
                        "title": "",
                        "status": "",
                        "imageUrl": "",
                        "endDate": "",
                        "catelogyId": ""
                    }
                }
            ],
            "totalCount": "",
            "resultCode": ""
        }
    }
}


SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionActivitiesListGetRequest request=new WarePromotionActivitiesListGetRequest();
request.setPromotionsId( 123 );
request.setPage( 123 );
request.setPageSize( 123 );
request.setClient( "jingdong" );
WarePromotionActivitiesListGetResponse response=client.execute(request);

6.根据促销活动id获得促销活动商品列表
接口名称

jingdong.ware.promotion.activityware.list.get


接口应用场景
无线应用 网站应用


API用户授权类型
不需要


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

应用级输入参数

名称 类型 是否必须 示例值 描述
activityId  Number  是 353  促销活动id 
page  Number  是 1  页码 
pageSize  Number  是 10  分页大小 
client  String  是 apple  客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
cmsActivityWareList  CmsActivityWareList 

CmsActivityWareList属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
totalCount  Number  否
总记录数 
couponStatus  Number  否

couponURL  String  否

roleIds  String  否

cmsActivityRebateImg  String  否

cmsActivityWareList  CmsActivityWare[]  否

CmsActivityWare[]属性

名称 类型 是否必须 示例值 描述
cmsActivityWare  CmsActivityWare  否
广告词 

CmsActivityWare属性

名称 类型 是否必须 示例值 描述
adWord  String  否
广告词 
isBook  Boolean  否
是否为图书 
canFreeRead  Boolean  否
是否免费阅读 
endRemainTime  String  否
秒杀离结束时间 
imageUrl  String  否
商品图片url 
jdPrice  Number  否
京东价 
martPrice  Number  否
市场价（部分商品可能不返回） 
startRemainTime  String  否
秒杀离开始时间 
skuId  String  否
商品编号 
wareName  String  否
商品名称 

返回示例

JSON数据格式

{
    "jingdong_ware_promotion_activityware_list_get_response": {
        "cmsActivityWareList": {
            "couponStatus": "",
            "totalCount": "",
            "couponURL": "",
            "resultCode": "",
            "cmsActivityWareLists": [
                {
                    "cmsActivityWare": {
                        "wareName": "",
                        "martPrice": "",
                        "startRemainTime": "",
                        "imageUrl": "",
                        "adWord": "",
                        "skuId": "",
                        "jdPrice": "",
                        "endRemainTime": "",
                        "canFreeRead": "",
                        "isBook": ""
                    }
                }
            ],
            "cmsActivityRebateImg": "",
            "roleIds": ""
        }
    }
}

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionActivitywareListGetRequest request=new WarePromotionActivitywareListGetRequest();
request.setActivityId( 123 );
request.setPage( 123 );
request.setPageSize( 123 );
request.setClient( "jingdong" );
WarePromotionActivitywareListGetResponse response=client.execute(request);

7.根据三级类目获取类目下推荐商品列表

接口名称

jingdong.ware.promotion.categoryware.list.get 


接口应用场景

无线应用 网站应用


API用户授权类型
不需要


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

应用级输入参数

名称 类型 是否必须 示例值 描述
cid  Number  是 653  分类编号 
num  Number  否 1  商品推荐数目 
client  String  是
客户端类型(apple、iPad、android、m、wp、wp7、Symbian、qt、androidTv、win8、android、Pad) 

返回结果

名称 类型 示例值 描述
wareInfoList  WareInfoList 

WareInfoList属性

名称 类型 是否必须 示例值 描述
resultCode  Number  否
接口返回信息码 
wareInfoList  WareInfo[]  否

WareInfo[]属性

名称 类型 是否必须 示例值 描述
wareInfo  WareInfo  否
广告词 

WareInfo属性

名称 类型 是否必须 示例值 描述
adWord  String  否
广告词 
isBook  Boolean  否
是否为图书 
canFreeRead  Boolean  否
是否免费阅读 
endRemainTime  String  否
秒杀离结束时间 
imageUrl  String  否
商品图片url 
jdPrice  Number  否
京东价 
martPrice  Number  否
市场价 
startRemainTime  String  否
秒杀离开始时间 
skuId  String  否
商品编号 
wareName  String  否
商品名称 

返回示例

JSON数据格式

{
    "jingdong_ware_promotion_categoryware_list_get_response": {
        "wareInfoList": {
            "resultCode": "",
            "wareInfoList": [
                {
                    "wareInfo": {
                        "wareName": "",
                        "martPrice": "",
                        "startRemainTime": "",
                        "imageUrl": "",
                        "adWord": "",
                        "skuId": "",
                        "jdPrice": "",
                        "endRemainTime": "",
                        "canFreeRead": "",
                        "isBook": ""
                    }
                }
            ]
        }
    }
}

SDK调用示例

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);
WarePromotionCategorywareListGetRequest request=new WarePromotionCategorywareListGetRequest();
request.setCid( 123 );
request.setNum( 123 );
request.setClient( "jingdong" );
WarePromotionCategorywareListGetResponse response=client.execute(request);