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.integral.query 积分兑换分页查询
¥免费

积分兑换活动分页查询

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringY10每页条数
activityNameStringN2019积分兑换活动积分兑换互动弄名称
startTimeStringN2020-01-01 00:00:00活动开始时间
endTimeStringN2020-03-01 00:00:00活动结束时间
activityStatusStringNs1s4:待开始 s1:进心中 s2:已结束 s7:已终止
shopCodeStringY30000281店铺编码
响应参数
名称 类型 示例值 描述
totalRecordsString50总条数
pageNoString1当前页数
pageSizeStringpageSize每页记录条数
activityListString
activityCodeStringJFDH000000001活动编码
activityNameString2019积分兑换活动活动名称
activityTypeString55活动类型
supplierCodeString700123456商家编码
activityStatusNameString进行中活动状态
createTimeString2020-01-01 00:00:00创建时间
startTimeString2020-01-01 00:00:00活动开始时间
endTimeString2020-01-01 00:00:00活动结束时间
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryIntegral>
      <shopCode>30000281</shopCode>
      <pageNo>1</pageNo>
      <activityName>2019积分兑换活动</activityName>
      <activityStatus>s1</activityStatus>
      <pageSize>10</pageSize>
      <startTime>2020-01-01 00:00:00</startTime>
      <endTime>2020-03-01 00:00:00</endTime>
    </queryIntegral>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryIntegral": {
        "shopCode": "30000281",
        "pageNo": "1",
        "activityName": "2019积分兑换活动",
        "activityStatus": "s1",
        "pageSize": "10",
        "startTime": "2020-01-01 00:00:00",
        "endTime": "2020-03-01 00:00:00"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <queryIntegral>
      <totalRecords>50</totalRecords>
      <pageNo>1</pageNo>
      <pageSize>pageSize</pageSize>
      <activityList>
        <activityCode>JFDH000000001</activityCode>
        <createTime>2020-01-01 00:00:00</createTime>
        <activityName>2019积分兑换活动</activityName>
        <activityStatusName>进行中</activityStatusName>
        <startTime>2020-01-01 00:00:00</startTime>
        <supplierCode>700123456</supplierCode>
        <endTime>2020-01-01 00:00:00</endTime>
        <activityType>55</activityType>
      </activityList>
    </queryIntegral>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryIntegral": [
        {
          "totalRecords": "50",
          "pageNo": "1",
          "pageSize": "pageSize",
          "activityList": [
            {
              "activityCode": "JFDH000000001",
              "createTime": "2020-01-01 00:00:00",
              "activityName": "2019积分兑换活动",
              "activityStatusName": "进行中",
              "startTime": "2020-01-01 00:00:00",
              "supplierCode": "700123456",
              "endTime": "2020-01-01 00:00:00",
              "activityType": "55"
            }
          ]
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.queryintegral.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.queryintegral.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.queryintegral.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.mpms 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ