开放服务-API列表

热词搜索：

suning.online.fourpageactivity.query 四级页查询促销活动

￥免费

四级页查询促销活动

公共参数

名称	类型	是否必须	示例值	描述
appMethod	String	Y	suning.custom.category.query	方法名
appRequestTime	String	Y	2012-04-25 20:23:30	时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。
format	String	N	XML	默认xml,可指定格式为xml,json
appKey	String	Y	b0c332a133c102765f39de**********	分配给应用的访问令牌
versionNo	String	Y	v1.2	API的版本，目前为v1.2版本
signInfo	String	Y	460d7ff15b073e463125b4**********	appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写)，其中appSecret为appKey对应的密钥
access_token	String	N	a1c5c62b08df3a3cbf7efd**********	采用OAuth授权方式为必填参数

请求参数

名称	类型	是否必须	示例值	描述
memberNo	String	Y	18397652345	会员编号（在实际业务中，如果外平台允许顾客不登录外平台调用此接口，那么外平台可以传入一个公共会员号，外平台保证此公共会员号不与真实会员号重复即可；如果顾客已经登录，则建议传入顾客在外平台的真实唯一会员编号）
chanId	String	Y	01	操作渠道（01:PC，02:APP，03:WAP）
city	String	Y	南京市	城市名称（即苏宁标准城市名）
activityRange	String	Y	1	促销活动范围（1、主商品活动查询；2、配件商品可选搭配活动查询；），默认传：【1】主商品活动查询；
cmmdtyCode	String	Y	123123123123123123	商品编码（苏宁标准18位商品编码）
price	String	Y	1.00	商品价格
businessSign	String	Y	1	商品业务标识（0：普通商品；1：海外购；）默认传：【0】普通商品；
marketingActivityType	String	Y	4-1	营销活动类型（0：普通商品；4-1：大聚惠；4-9：限时促销；4-12：掌上抢；14：促销价；15：大促价；）
shopCode	String	N	7611	店铺编码
supplierCode	String	N	0000000001	供应商编码

响应参数

名称	类型	示例值	描述
activityList	String
activityType	String	2	活动类型（2：订单促销；6 : 领券）活动类型为【2】且奖励类型为【1】，取出【订单直降】；活动类型为【6】且奖励类型为【2】，取出【免费领劵】；
activityLabel	String	1	活动标签（1：满减；7：领券；）
activityId	String	1234567123	促销活动编码
promotionLabel	String	促销标签	促销标签（注意：此字段已作废）
activitySecretKey	String	123	活动秘钥，用于免费领券加密
terminalType	String	01_1001	活动终端（若多个终端，则下划线拼接如：01_1001； 01：PC、 02：APP、 03：WAP、1001、1002、1003、1004、1005、1006）
startTime	String	2019-12-11 20:23:16	活动开始时间
endTime	String	2019-12-31 23:59:59	活动结束时间
bonusList	String
bonusType	String	1	奖励类型（1：直降，2：送券）活动类型为【2】且奖励类型为【1】，取出【订单直降】；活动类型为【6】且奖励类型为【2】，取出【免费领劵】；奖励数组顺序：从小到大；
bonusLabel	String	满XXX元减XX元	奖励促销标签；（可用于商品详情页的订单直降活动标签展示；返回内容与<促销标签>字段类似，推荐优先使用本字段的内容展示；【订单直降】时才有该字段值（例如：满2件打8.5折,满3件打7.5折；例如：满99用15）
couponType	String	10001	券类型活动类型为免费领券时必有值； 10001 云券 10002 限品类云券 10004 易券 10005 限品类易券 10009 无敌券
couponValue	String	1.00	券面值
couponRuleId	String	12345	券使用规则编码
couponPromotionLabel	String	满99用15	券规则优惠说明（可用于商品详情页的优惠劵标签展示；例如：满99用15）
couponStartTime	String	2018-01-01 23:59:59	券使用开始时间，格式： yyyy-mm-dd hh24:mi:ss,
couponEndTime	String	2018-01-01 23:59:59	券使用结束时间，格式： yyyy-mm-dd hh24:mi:ss,
couponShowType	String	1	券标识类型: 1.金额券 2，打折券
bonusrule	String
bonusruleId	String	1	1. 活动 2.券
baseAddUpType	String	0	0：无1：固定值 2：每 3：满 5：阶梯时间 6：阶梯次数示例：满100减10 ，基数积累方式取值满100元3件基数积累方式取值固定值
bounsLimit	String	100	示例：满100元打8.8折的100 满3件打9折，最大优惠200的基数值是3
baseQuantifierType	String	1	1：金额: 2：人数 3：件数 4：概率 5 : 类目类型基数量词的类型：例如满100减10基数值量词是类型是金额，满3件打9折，最大优惠200的基数类型是折扣满3件减1件基数积累类型是件数
bounsAmount	String	10	示例：满100减10奖励数值即10 满3件打9折奖励值是1折即0.1。当促销活动为满额打折/满件打折两种场景时，券和活动的传值不一样。例如：100元打9折，如果是券，取值为9；如果是活动，取值为0.1 满3件打9折，如果是券，取值为9；如果是活动，取值为0.1。
rewardQuantifierType	String	1	1：金额: 2：人数 3：件数 4：概率 5：折扣 6、外围系统指定8、定价励量词类型示例满100减10类型是金额，满100打9折是折扣，满3件减1件是件数
singleMaxRewardAmount	String	200	最多减免Y元的Y 即单次奖励最大奖励多少。示例：满100打9折，最大优惠200，其中200即为最大值

请求示例

XML示例
JSON示例

复制全部代码

                                <sn_request>
  <sn_body>
    <queryFourpageactivity>
      <shopCode>7611</shopCode>
      <memberNo>18397652345</memberNo>
      <activityRange>1</activityRange>
      <marketingActivityType>4-1</marketingActivityType>
      <city>南京市</city>
      <price>1.00</price>
      <cmmdtyCode>123123123123123123</cmmdtyCode>
      <chanId>01</chanId>
      <businessSign>1</businessSign>
      <supplierCode>0000000001</supplierCode>
    </queryFourpageactivity>
  </sn_body>
</sn_request>

                                {
  "sn_request": {
    "sn_body": {
      "queryFourpageactivity": {
        "shopCode": "7611",
        "memberNo": "18397652345",
        "activityRange": "1",
        "marketingActivityType": "4-1",
        "city": "南京市",
        "price": "1.00",
        "cmmdtyCode": "123123123123123123",
        "chanId": "01",
        "businessSign": "1",
        "supplierCode": "0000000001"
      }
    }
  }
}

响应示例

XML示例
JSON示例

复制全部代码

                              <sn_responseContent>
  <sn_body>
    <queryFourpageactivity>
      <activityList>
        <activitySecretKey>123</activitySecretKey>
        <activityId>1234567123</activityId>
        <promotionLabel>促销标签</promotionLabel>
        <startTime>2019-12-11 20:23:16</startTime>
        <endTime>2019-12-31 23:59:59</endTime>
        <activityLabel>1</activityLabel>
        <activityType>2</activityType>
        <terminalType>01_1001</terminalType>
        <bonusList>
          <couponEndTime>2018-01-01 23:59:59</couponEndTime>
          <couponPromotionLabel>满99用15</couponPromotionLabel>
          <couponRuleId>12345</couponRuleId>
          <couponShowType>1</couponShowType>
          <couponType>10001</couponType>
          <couponStartTime>2018-01-01 23:59:59</couponStartTime>
          <bonusLabel>满XXX元减XX元</bonusLabel>
          <bonusrule>
            <bounsLimit>100</bounsLimit>
            <singleMaxRewardAmount>200</singleMaxRewardAmount>
            <baseAddUpType>0</baseAddUpType>
            <rewardQuantifierType>1</rewardQuantifierType>
            <baseQuantifierType>1</baseQuantifierType>
            <bonusruleId>1</bonusruleId>
            <bounsAmount>10</bounsAmount>
          </bonusrule>
          <bonusType>1</bonusType>
          <couponValue>1.00</couponValue>
        </bonusList>
      </activityList>
    </queryFourpageactivity>
  </sn_body>
</sn_responseContent>

                              {
  "sn_responseContent": {
    "sn_body": {
      "queryFourpageactivity": {
        "activityList": [
          {
            "activitySecretKey": "123",
            "activityId": "1234567123",
            "promotionLabel": "促销标签",
            "startTime": "2019-12-11 20:23:16",
            "endTime": "2019-12-31 23:59:59",
            "activityLabel": "1",
            "activityType": "2",
            "terminalType": "01_1001",
            "bonusList": [
              {
                "couponEndTime": "2018-01-01 23:59:59",
                "couponPromotionLabel": "满99用15",
                "couponRuleId": "12345",
                "couponShowType": "1",
                "couponType": "10001",
                "couponStartTime": "2018-01-01 23:59:59",
                "bonusLabel": "满XXX元减XX元",
                "bonusrule": {
                  "bounsLimit": "100",
                  "singleMaxRewardAmount": "200",
                  "baseAddUpType": "0",
                  "rewardQuantifierType": "1",
                  "baseQuantifierType": "1",
                  "bonusruleId": "1",
                  "bounsAmount": "10"
                },
                "bonusType": "1",
                "couponValue": "1.00"
              }
            ]
          }
        ]
      }
    }
  }
}

异常示例

XML示例
JSON示例

复制全部代码


  
  	API异常码
  	异常码中文描述

{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}

业务异常码

异常码	错误描述	解决方案
biz.online.queryfourpageactivity.enumeration-error:*	参数的可选值错误	请检查此参数的值,*号表示参数字段名
biz.online.queryfourpageactivity.missing-parameter:*	参数必填	请检查此参数的值,*号表示参数字段名
biz.online.queryfourpageact.missing-parameter:*	参数必填	请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result	查询没结果	请检查查询参数
isp.sys.service.unavailable.pangu	服务不可用	请联系苏宁技术人员
biz.online.queryfourpageact.invalid-biz:100	未查询到平台配置信息	请联系苏宁技术人员
biz.online.queryfourpageactivity.invalid-biz:101	商品不在选品范围内,商品编码XX	请联系苏宁技术人员
biz.online.queryfourpageactivity.invalid-biz:102	地址解析错误，地址描述XX	请联系苏宁技术人员
biz.online.queryfourpageactivity.invalid-biz:103	会员编号转换异常，会员号XX	请联系苏宁技术人员
biz.online.queryfourpageactivity.invalid-biz:105	参数必填:具体参数	请联系苏宁技术人员

公共异常码

异常码	错误描述	解决方案
sys.check.user-permission:inexistence	访问令牌不存在	更换访问令牌
sys.check.user-permission:overdue	访问令牌已过期	请使用刷新令牌刷新
sys.check.api-permission:inexistence	Api方法不存在	请参考帮助中心
sys.check.api-permission:overdue	Api方法已过期	请参考帮助中心
sys.check.method-permission:authority	无权操作此api	确认是否有访问该方法权限
sys.auth.vendor-request:errory	无权操作此供应商	请确认供应商编码是否正确
sys.controller.api-request:limit	Api请求受控	超过请求次数
sys.check.app-time:error	请求参数错误api请求时间误差大	参考帮助中心
sys.check.request-params:error	请求报文结构错误	参考帮助中心、日期格式等
sys.check.starttime-format:error	请求开始时间错误	参考帮助中心、日期格式等
biz.handler.data-get:success	业务数据查询成功	无
biz.handler.data-get:fail	业务数据查询失败	检查请求条件
biz.handler.data-get:no-result	业务数据结果为空	无
sys.check.pageno-format:error	pageNo格式错误，只允许1到99999之间的整数	检查pageNo输入是否有误
sys.check.pagesize-format:error	pageSize格式错误，只允许1到50之间的整数(订单相关是1到100)	检查pageSize输入是否有误
sys.check.page-param:error	pageNo或者pageSize不在要求范围内，pageNo只允许1到99999之间的整数，pageSize只允许1到50之间的整数(订单相关是1到100)	检查pageNo和pageSize输入是否有误
sys.check.miss-time:starttime	不存在开始时间(节点)	检查输入
sys.check.miss-time:endtime	不存在结束时间(节点)	检查输入
sys.check.starttime-value:null	开始时间为空(值)	检查输入
sys.check.endtime-value:null	结束时间为空(值)	检查输入
sys.check.starttime-format:error	校验开始时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.endtime-format:error	校验结束时间不合法，格式yyyy-MM-dd HH:mm:ss	检查时间格式
sys.check.query-time:error	开始时间是否小于结束时间	检查开始和结束时间大小
sys.check.query-time:outofrange	时间查询是否超出指定范围	检查时间范围
sys.check.app-sign:null	签名信息为空	检查签名信息
sys.check.app-sign:error	签名信息错误	检查签名信息
sys.check.missing-parameter:apiversion	API版本号未指定	检查API版本号
sys.check.missing-parameter:appRequestTime	请求时间丢失	检查请求时间
sys.check.missing-nestElement:sn_body	缺少sn_body节点	检查sn_body是否存在
sys.check.user-permission:inexistence	用户key不存在	检查用户key是否存在
biz.handler.batch-handler:no-support	非查询类API不支持批量操作	检查API类型
biz.handler.request-message:error	查询类API输入多个业务节点	检查业务节点
sys.check.header-param:null	header参数为空	请检查header参数
sys.controller.api-access:limit	访问限制	无
sys.controller.api-frequency:limit	访问频率限制	无
sys.error.network:failure	网络异常	无
sys.error.network-status:?	响应失败 ?为状态码	无
sys.check.snunionid.length.is.not:48	混淆会员编码长度不是48位	使用转换器转换混淆会员编码规定要求混淆会员编码48位

API工具

API TOOLS 在线测试工具异常码查询工具 SDK调用示例 SDK下载

FAQ

电商能力输出业务