退出
热词搜索：
API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API（新）
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.direcoupon.query 定向发券活动批量查询
￥免费

通过此接口可定向发券活动批量查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
activityStatus String N 1 活动状态编码。0全部状态；1未开始、2进行中、3已结束
startTime String N 2014-07-19 21:12:22 券有效期开始时间。查询开始时间。格式:yyyy-MM-dd HH:MM:SS若输入则开始时间和结束时间必须同时出现，开始时间和结束时间间隔不大于90天, 如果时间不输入，则默认查询当前时间往前三天的数据。券有效期开始时间，券有效期结束时间成对出现
endTime String N 2014-07-20 21:12:21 券有效期结束时间。查询结束时间。格式:yyyy-MM-dd HH:MM:SS若输入则开始时间和结束时间必须同时出现，开始时间和结束时间间隔不大于90天, 如果时间不输入，则默认查询当前时间往前三天的数据。券有效期开始时间，券有效期结束时间成对出现
pageNo String N 1 页码。页码。默认值：1。页码和每页条数成对出现
pageSize String N 10 每页条数。每页条数。最大值：50。默认值：10。页码和每页条数成对出现
响应参数
名称 类型 示例值 描述
activityCode String 1001434507 促销活动ID。
activityName String 我爱我家啊 促销活动名称。
startTime String 2014-07-19 21:12:22 券有效期开始时间。
endTime String 2014-07-20 21:12:22 券有效期结束时间。
createTime String 2014-07-12 21:12:22 活动创建时间。
activityStatus String 1 活动状态。1
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request><sn_body><queryDireCoupon><activityStatus>1</activityStatus><startTime>2015-06-18 20:26:47</startTime><endTime>2015-07-18 20:26:47</endTime><pageNo>1</pageNo><pageSize>10</pageSize></queryDireCoupon></sn_body></sn_request>
                                
                                {"sn_request": {"sn_body": {"queryDireCoupon": {"activityStatus": "1","startTime": "2015-06-18 20:26:47","endTime": "2015-07-18 20:26:47","pageNo": "1","pageSize": "10"}}}}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent><sn_body><queryDireCoupon><activityCode>1001434507</activityCode><activityName>我爱我家啊</activityName><startTime>2014-07-19 21:12:22</startTime><endTime>2014-07-20 21:12:22</endTime><createTime>2014-07-12 21:12:22</createTime><activityStatus>1</activityStatus></queryDireCoupon><queryDireCoupon><activityCode>1001434507</activityCode><activityName>我爱我家啊</activityName><startTime>2014-07-19 21:12:22</startTime><endTime>2014-07-20 21:12:22</endTime><createTime>2014-07-12 21:12:22</createTime><activityStatus>1</activityStatus></queryDireCoupon></sn_body></sn_responseContent>
                              
                              {"sn_responseContent": {"sn_body": {"queryDireCoupon": [{"activityCode": "1001434507","activityName": "我爱我家啊","startTime": "2014-07-19 21:12:22","endTime": "2014-07-20 21:12:22","createTime": "2014-07-12 21:12:22","activityStatus": "1"},{"activityCode": "1001434507","activityName": "我爱我家啊","startTime": "2014-07-19 21:12:22","endTime": "2014-07-20 21:12:22","createTime": "2014-07-12 21:12:22","activityStatus": "1"}]}}}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.handler.data-get:no-result 查询无结果 请输入正确参数。
isp.sys.service.unavailable.mpms 活动开始时间格式错误 请联系苏宁技术人员。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：定向发券活动批量查询接口如何使用？

A：通过此接口可定向发券活动批量查询