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.xnactivity.query X元N件活动批量查询
¥免费

通过此接口可X元N件活动批量查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNo String N 1 页码。页码。默认值:1。页码和每页条数成对出现
pageSize String N 10 每页条数。每页条数。最大值:50。默认值:10。页码和每页条数成对出现
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天,如果时间不输入,则默认查询当前时间往前三天的数据。
activityStatus String N 1 活动状态。0全部;1草稿;2处理中;3待开始;4进行中;5已结束;6已暂停;7已终止;8未生效
响应参数
名称 类型 示例值 描述
activityCode String 15071610082310000001 促销活动ID。促销活动的唯一标识
activityName String eeee 活动名称。
startTime String 2015-07-16 11:28:24 活动开始时间。
endTime String 2015-08-06 11:28:25 活动结束时间。
activityStatus String 1 活动状态。0全部;1草稿;2处理中;3待开始;4进行中;5已结束;6已暂停;7已终止;8未生效
discountContext String 任选1件22.00元 优惠内容。任选3件50元
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
	<sn_body>
		<queryXNActivity>
			<pageNo>1</pageNo>
			<pageSize>50</pageSize>
			<startTime>2015-07-06 21:12:22</startTime>
			<endTime>2015-07-19 21:12:21</endTime>
			<activityStatus>8</activityStatus>
		</queryXNActivity>
	</sn_body>
</sn_request>
	  
                                
                                
{
	"sn_request": {
		"sn_body": {
			"queryXNActivity": {
				"pageNo": "1",
				"pageSize": "50",
				"startTime": "2015-07-06 21:12:22",
				"endTime": "2015-07-19 21:12:21",
				"activityStatus": "8"
			}
		}
	}
}
      
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
	<sn_head>
		<pageTotal>1</pageTotal>
		<pageNo>1</pageNo>
		<totalSize>2</totalSize>
		<returnMessage>biz.handler.data-get:success</returnMessage>
	</sn_head>
	<sn_body>
		<queryXNActivity>
			<activityCode>15071610082310000001</activityCode>
			<activityName>eeee</activityName>
			<startTime>2015-07-16 11:28:24</startTime>
			<endTime>2015-08-06 11:28:25</endTime>
			<activityStatus>s0</activityStatus>
			<discountContext>任选1件55.00元</discountContext>
		</queryXNActivity>
		<queryXNActivity>
			<activityCode>15070820162310000001</activityCode>
			<activityName>测试活动信息</activityName>
			<startTime>2015-07-08 21:35:37</startTime>
			<endTime>2015-08-06 21:35:38</endTime>
			<activityStatus>s1</activityStatus>
			<discountContext>任选1件22.00元</discountContext>
		</queryXNActivity>
	</sn_body>
</sn_responseContent>
      
                              
                              
{
    "sn_responseContent": {
        "sn_head": {
            "pageTotal": "1",
            "pageNo": "1",
            "totalSize": "2",
            "returnMessage": "biz.handler.data-get:success"
        },
        "sn_body": {
            "queryXNActivity": [
                {
                    "activityCode": "15071610082310000001",
                    "activityName": "eeee",
                    "startTime": "2015-07-16 11:28:24",
                    "endTime": "2015-08-06 11:28:25",
                    "activityStatus": "s0",
                    "discountContext": "任选1件55.00元"
                },
                {
                    "activityCode": "15070820162310000001",
                    "activityName": "测试活动信息",
                    "startTime": "2015-07-08 21:35:37",
                    "endTime": "2015-08-06 21:35:38",
                    "activityStatus": "s1",
                    "discountContext": "任选1件22.00元"
                }
            ]
        }
    }
}
      
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.xnactivity.acstatuscode:format-error 活动状态格式错误 请输入正确参数。
biz.handler.data-get:no-result 查询无结果 请输入正确参数。
isp.sys.service.unavailable.mpms 服务不可用(系统异常) 请联系苏宁技术人员。
公共异常码
API工具
FAQ

Q:X元N件活动批量查询接口如何使用?

A:通过此接口可X元N件活动批量查询