首页>促销API>jingdong.seller.promotion.list

促销API

jingdong.pop.market.write.promotion.gift.reject
对应需要人工审核的促销,执行审核驳回操作(赠品促销)
jingdong.pop.market.write.promotion.sum.approve
对应需要人工审核的促销,执行审核通过操作(总价促销)
jingdong.seller.promotion.list
促销列表查询接口
jingdong.seller.promotion.ordermode.list
根据促销编号获取促销的订单规则
jingdong.seller.coupon.write.close
关闭优惠券
jingdong.seller.coupon.write.create
新建优惠券
jingdong.seller.coupon.read.getCouponList
根据指定条件(分页)查询商家创建的优惠券
jingdong.seller.promotion.v2.suspend
暂停促销
jingdong.seller.promotion.v2.resume
重启促销
jingdong.seller.promotion.v2.unit.beanrequired.create
创建京豆优惠购促销
jingdong.seller.promotion.v2.reject
人工审核驳回
jingdong.seller.promotion.v2.approve
人工审核通过
jingdong.seller.promotion.v2.unit.limit.create
创建限购促销
jingdong.seller.promotion.v2.remove
删除促销
jingdong.seller.promotion.v2.sku.count
查询促销SKU个数
jingdong.seller.promotion.v2.list
查询促销列表
jingdong.seller.promotion.v2.get
查询促销详情
jingdong.seller.promotion.v2.count
查询促销个数
jingdong.promotion.updateLineationPrice
调划线价接口
jingdong.seller.promotion.add
新建促销信息
jingdong.seller.promotion.activitymode.add
添加活动规则
jingdong.pop.market.retrieve.promotion.getPromoUserList
查询指定令牌促销的用户列表
jingdong.seller.promotion.commit
null
jingdong.seller.promotion.check
null
jingdong.seller.promotion.suspend
暂停促销,使促销暂不生效,只能对已生效的促销进行暂停
jingdong.seller.promotion.resume
重启促销,使暂停的促销重新生效,只能对暂停的促销进行重启操作。
jingdong.seller.promotion.delete
删除促销,只能删除未审核、已驳回、已生效、已暂停等状态的促销
jingdong.pop.market.write.promotion.sum.reject
对应需要人工审核的促销,执行审核驳回操作(总价促销)
jingdong.pop.market.write.promotion.gift.approve
对应需要人工审核的促销,执行审核通过操作(赠品促销)
jingdong.seller.promotion.sku.list
促销sku列表查询
jingdong.pop.market.write.promotion.sum.remove
删除总价促销
jingdong.seller.promotion.v2.sku.list
查询促销SKU列表
jingdong.seller.promotion.v2.unit.full.create
创建单品促销
jingdong.seller.promotion.prop.add
添加促销道具
jingdong.seller.promotion.sku.add
添加参加促销的sku
jingdong.seller.promotion.activitymode.get
根据促销编号获取促销的活动规则
jingdong.seller.promotion.prop.list
根据促销编号获取促销的道具列表
jingdong.seller.promotion.ordermode.add
添加订单规则
jingdong.seller.coupon.read.getCouponCount
统计满足条件的优惠券个数
jingdong.seller.promotion.v2.unit.prop.create
创建送道具促销
jingdong.seller.promotion.v2.order.discount.create
创建折扣促销

jingdong.seller.promotion.list      促销列表查询接口

API功能描述

分页查询促销列表,目前可以根据类型、状态进行查询,也支持组合查询

授权类型

需要

应用场景

商家应用 通用应用 百度微购 口袋限制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

应用级别输入参数

名称 类型 是否必须 示例值 描述
type  Number  促销类型,可选值:单品促销(1),赠品促销(4),套装促销(6),总价促销(10) 
status  Number  促销状态,可选值:驳回(1),未审核(2),人工审核(3),审核通过(4),已生效(5) 
begin_time  String  2013-11-21 13:30:59   促销开始时间,格式为yyyy-MM-dd HH:mm:ss,(查询促销开始时间大于等于该值的促销) 
end_time  String  2013-11-21 13:40:59  促销结束时间,格式为yyyy-MM-dd HH:mm:ss,(查询促销结束时间小于等于该值的促销) 
sku_id  Number  112233  商品skuId(查询sku参加的促销) 
favor_mode  Number  null  总价促销订单规则类型,可选值为:满赠(0),满减(1),多买优惠(7),满减送(16) 
page  Number  页码(必须为正整数) 
size  Number  10  每页记录个数(每页最少1个,最多10个) 

返回结果

名称 类型 示例值 描述
total_count  Number  15   促销总数量  
promotion_v_o_s  PromotionVO[]    促销信息列表,包含促销编号、名称、时间、类型、状态、范围、会员级别等字段。  

返回示例值

错误码

错误码 错误描述 解决方案
没有符合的记录

API测试工具

FAQ