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

网盟业务

会员API
联盟订单API
大聚惠API
联盟商品API
招商推广活动API
获取推广链接API
优惠券推广API
机构推客API
店铺API
异常码自查工具
suning.netalliance.couponinfo.query 查询券领用情况
￥免费

通过券的URL查询该券的信息和剩余数量

公共参数
请求参数
名称 类型 是否必须 示例值 描述
quanUrlStringYhttps://quan.suning.com/lqzx_recommend.do?activityId=201903190001000725&activitySecretKey=kwrK5exkwqreo3QzO3GL7TSX券URL
couponNumStringN232123123券编码
响应参数
名称 类型 示例值 描述
activityIdString201907040010040322券活动ID
couponValueString5.00券面额
couponCountString10000券总张数
couponRemainingAmountString50券剩余数量
preferentialDistinctString满x钱用，最高减y奖励优惠说明
couponStartTimeString2019-07-04 14:48:04券的使用开始时间
couponEndTimeString2019-07-04 14:48:04券的使用结束时间
startTimeString2019-07-04 14:48:04券的领取开始时间
endTimeString2019-07-04 14:48:04券的领取结束时间
couponPlatformString自营券平台
isValidCouponString00代表有效1代表无效
channelIdString31，32，33，终端渠道： 31：网站、 32：移动终端、 33：云信终端、 34：电话销售、 35：电视终端、 36：WAP、 37：门店、 38：超市 39：PPTV 48：零售云APP 59：苏鲜生超市
memberAttributeListString
memberAttributeLimitString123123142000000450 :校园普通用户 142000000155 : 校园VIP F2000020 :super试用期 F2000030 :super正式期
vipMemberLimitString1付费会员限制1：限制 0：不限制
memberLevelString161000000130会员等级161000000100：新人 161000000110：V1 161000000120：V2 161000000130：V3 空：不限制
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryCouponinfo>
      <couponNum>232123123</couponNum>
      <quanUrl>https://quan.suning.com/lqzx_recommend.do?activityId=201903190001000725&amp;activitySecretKey=kwrK5exkwqreo3QzO3GL7TSX</quanUrl>
    </queryCouponinfo>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryCouponinfo": {
        "couponNum": "232123123",
        "quanUrl": "https://quan.suning.com/lqzx_recommend.do?activityId=201903190001000725&activitySecretKey=kwrK5exkwqreo3QzO3GL7TSX"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <queryCouponinfo>
      <couponRemainingAmount>50</couponRemainingAmount>
      <couponCount>10000</couponCount>
      <couponValue>5.00</couponValue>
      <couponEndTime>2019-07-04 14:48:04</couponEndTime>
      <activityId>201907040010040322</activityId>
      <couponPlatform>自营</couponPlatform>
      <preferentialDistinct>满x钱用，最高减y</preferentialDistinct>
      <memberAttributeList>
        <memberLevel>161000000130</memberLevel>
        <vipMemberLimit>1</vipMemberLimit>
        <memberAttributeLimit>123123</memberAttributeLimit>
      </memberAttributeList>
      <couponStartTime>2019-07-04 14:48:04</couponStartTime>
      <startTime>2019-07-04 14:48:04</startTime>
      <endTime>2019-07-04 14:48:04</endTime>
      <isValidCoupon>0</isValidCoupon>
      <channelId>31，32，33，</channelId>
    </queryCouponinfo>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryCouponinfo": {
        "couponRemainingAmount": "50",
        "couponCount": "10000",
        "couponValue": "5.00",
        "couponEndTime": "2019-07-04 14:48:04",
        "activityId": "201907040010040322",
        "couponPlatform": "自营",
        "preferentialDistinct": "满x钱用，最高减y",
        "memberAttributeList": {
          "memberLevel": "161000000130",
          "vipMemberLimit": "1",
          "memberAttributeLimit": "123123"
        },
        "couponStartTime": "2019-07-04 14:48:04",
        "startTime": "2019-07-04 14:48:04",
        "endTime": "2019-07-04 14:48:04",
        "isValidCoupon": "0",
        "channelId": "31，32，33，"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.netalliance.querycouponinfo.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.netalliance.querycouponinfo.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.netalliance.querycoupon.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.netalliance.querycoupon.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.suis 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ