退出
热词搜索：
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.galaxiecoupon.get 星河免费领券接口
￥增值

星河免费领券接口

返回结果参考resultFlag此字段

当resultFlag为1时，领券成功，返回具体的券信息

当resultFlag为0时，领券失败，具体失败原因参考failMessage字段

当resultFlag为3时，触发风控，需用户操作滑块验证。此时出参serialNo（请求流水号）、valiNo（业务唯一标识）、ticket（验证码平台tickect）将不为空，

前端根据ticket获取验证码token，将验证码token、请求流水号、业务唯一标识分别赋值给idfToken、serialNo、valiNo，其余必填参数保持不变再次调用此接口重新领券。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
bonusTrigerIdStringY3励触发事件：3=免费领取 27=社会化营销活动奖
activityIdStringY202004010001299290券活动编码
activitySecretKeyStringYfXO2jW434G9EXtTUelN71K5U券秘钥，用于免费领券加密
snUnionIdStringNbfb3ae009a31e98f4fa13ee41c6cbfb3ae01f9a31e9884fa混淆会员编码
terminalIdStringY3231：网站、 32：移动终端、 33：云信终端、 34：电话销售、 35：电视终端、 36：WAP、 37：电器门店 38：超市门店&苏宁小店 39：PPTV 40：商业广场 41：微店 42：分销渠道 43:小海狮APP 44：微仓渠道 47：红孩子门店 48：零售云 49：体育门店 59：苏鲜生微信商城 小程序、wap传36，易购app传32；
cityIdStringN2券活动没有限制城市可以不传； 券活动限制城市，必传
termiSysStringYWindows"Windows"：Windows系统；"Linux"：Linux系统；"Macos"：Mac系统；"Android"：安卓系统；"IOS"：IOS系统；"HarmonyOS"：鸿蒙系统
miniSourceStringNwechat来源为易购app、WAP传空值；来源为易购小程序、达尔文小程序传"wechat"
dfpTokenStringYTHc0gl1713dc37bc5gJJx2a58操作设备指纹，前台传入
detectStringYmmds_97fc62e6ea2c41abf7745f51622c67b3人机识别码，前台传入
idfTokenStringNTHE0Kg17157544d8fsIFbb0d0___w7DDp8KLw75ow5MZbMOyImjCqsONBcOFw7hawqrCssOg验证码token
serialNoStringNsnyg612_39eaf0e06bbc54c387425bd94990f80c请求流水号
valiNoStringN202004010001299291+6002318564业务唯一标识,券id+会员id
requestIpStringY10.96.193.66取用户真实ip，且只传一个ip
appVersionStringN8.7.2.3APP外版本号，PC,WAP传空值""
memberIdStringN1234567890会员编码
响应参数
名称 类型 示例值 描述
resultFlagString0领券操作结果 0 失败 1 成功
failCodeString1操作结果为0时返回
failMessageString活动奖励触发事件不一致操作结果为0时返回
couponNameString免费券操作类型为2时，操作结果为1时需有值
couponRulesShowMsgString限平台全品类商品使用操作类型为2时，操作结果为1时需有值
couponRuleCodeString1202004010001147821操作类型为2时，操作结果为1时需有值
rewardsPreferentialString全额抵用操作类型为2时，操作结果为1时需有值
couponTypeString1000110001 云券 10002 限品类云券 10003 店铺云券 10004 易券 10005 限品类易券 10006 店铺易券 10007 易付宝通用券 10008 易付宝专用券 10009 无敌券 10010 免运费券 10011 店铺免运费券 10012 SIM卡券 10013 自营无敌券 10014 大聚惠理财券
couponNoStringC0000001696002操作类型为2时，操作结果为1时需有值
couponAmountString5.00操作类型为1、2时，操作结果为1时需有值
couponBalanceString5.00操作类型为2时，操作结果为1时需有值
isNextCouponString11：是 2：否
couponStartTimeString2020-04-04 10:36:42操作类型为2时，操作结果为1时需有值
couponEndTimeString2020-04-04 10:36:42操作类型为2时，操作结果为1时需有值
serialNoStringsnyg612_39eaf0e06bbc54c387425bd94990f80c请求流水号
valiNoString202004010001299291+6002318564业务唯一标识,券id+会员id
ticketString07d348ef6813d27fdc6ec9c57f64f98dd49a50dbb1ee0a66999b88b701db0d4590a98b02a55c7a20272c6d8a19c8b7858454582bcb6a5acf验证码平台tickect
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <getGalaxiecoupon>
      <activitySecretKey>fXO2jW434G9EXtTUelN71K5U</activitySecretKey>
      <idfToken>THE0Kg17157544d8fsIFbb0d0___w7DDp8KLw75ow5MZbMOyImjCqsONBcOFw7hawqrCssOg</idfToken>
      <appVersion>8.7.2.3</appVersion>
      <termiSys>Windows</termiSys>
      <dfpToken>THc0gl1713dc37bc5gJJx2a58</dfpToken>
      <detect>mmds_97fc62e6ea2c41abf7745f51622c67b3</detect>
      <miniSource>wechat</miniSource>
      <requestIp>10.96.193.66</requestIp>
      <cityId>2</cityId>
      <terminalId>32</terminalId>
      <valiNo>202004010001299291+6002318564</valiNo>
      <snUnionId>bfb3ae009a31e98f4fa13ee41c6cbfb3ae01f9a31e9884fa</snUnionId>
      <serialNo>snyg612_39eaf0e06bbc54c387425bd94990f80c</serialNo>
      <bonusTrigerId>3</bonusTrigerId>
      <activityId>202004010001299290</activityId>
      <memberId>1234567890</memberId>
    </getGalaxiecoupon>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getGalaxiecoupon": {
        "activitySecretKey": "fXO2jW434G9EXtTUelN71K5U",
        "idfToken": "THE0Kg17157544d8fsIFbb0d0___w7DDp8KLw75ow5MZbMOyImjCqsONBcOFw7hawqrCssOg",
        "appVersion": "8.7.2.3",
        "termiSys": "Windows",
        "dfpToken": "THc0gl1713dc37bc5gJJx2a58",
        "detect": "mmds_97fc62e6ea2c41abf7745f51622c67b3",
        "miniSource": "wechat",
        "requestIp": "10.96.193.66",
        "cityId": "2",
        "terminalId": "32",
        "valiNo": "202004010001299291+6002318564",
        "snUnionId": "bfb3ae009a31e98f4fa13ee41c6cbfb3ae01f9a31e9884fa",
        "serialNo": "snyg612_39eaf0e06bbc54c387425bd94990f80c",
        "bonusTrigerId": "3",
        "activityId": "202004010001299290",
        "memberId": "1234567890"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <getGalaxiecoupon>
      <couponName>免费券</couponName>
      <couponRulesShowMsg>限平台全品类商品使用</couponRulesShowMsg>
      <isNextCoupon>1</isNextCoupon>
      <ticket>07d348ef6813d27fdc6ec9c57f64f98dd49a50dbb1ee0a66999b88b701db0d4590a98b02a55c7a20272c6d8a19c8b7858454582bcb6a5acf</ticket>
      <couponRuleCode>1202004010001147821</couponRuleCode>
      <couponNo>C0000001696002</couponNo>
      <resultFlag>0</resultFlag>
      <rewardsPreferential>全额抵用</rewardsPreferential>
      <valiNo>202004010001299291+6002318564</valiNo>
      <failMessage>活动奖励触发事件不一致</failMessage>
      <serialNo>snyg612_39eaf0e06bbc54c387425bd94990f80c</serialNo>
      <couponEndTime>2020-04-04 10:36:42</couponEndTime>
      <couponBalance>5.00</couponBalance>
      <couponAmount>5.00</couponAmount>
      <couponType>10001</couponType>
      <couponStartTime>2020-04-04 10:36:42</couponStartTime>
      <failCode>1</failCode>
    </getGalaxiecoupon>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getGalaxiecoupon": {
        "couponName": "免费券",
        "couponRulesShowMsg": "限平台全品类商品使用",
        "isNextCoupon": "1",
        "ticket": "07d348ef6813d27fdc6ec9c57f64f98dd49a50dbb1ee0a66999b88b701db0d4590a98b02a55c7a20272c6d8a19c8b7858454582bcb6a5acf",
        "couponRuleCode": "1202004010001147821",
        "couponNo": "C0000001696002",
        "resultFlag": "0",
        "rewardsPreferential": "全额抵用",
        "valiNo": "202004010001299291+6002318564",
        "failMessage": "活动奖励触发事件不一致",
        "serialNo": "snyg612_39eaf0e06bbc54c387425bd94990f80c",
        "couponEndTime": "2020-04-04 10:36:42",
        "couponBalance": "5.00",
        "couponAmount": "5.00",
        "couponType": "10001",
        "couponStartTime": "2020-04-04 10:36:42",
        "failCode": "1"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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