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.actionrisk.query 风控用户行为
¥免费

行为动作类型:1:关注店铺;2:抽奖;3:分享;4:助力

用户行为类型,每次都要传。

当用户行为是1或者2关注店铺/抽奖,giftPickType字段,没有默认传空;

当用户行为是3:分享,传cutOrderNum字段,没有默认传空;

当用户行为是4:助力,传cutOrderNum/inviterUserId字段,没有默认传空;inviterUserId为被助力者的易购会员编码或者混淆会员编码


公共参数
请求参数
名称 类型 是否必须 示例值 描述
actionTypeStringY1行为动作类型:1:关注店铺;2:抽奖;3:分享;4:助力
snUnionIdStringY5232db605f31ea8f0fa13eeda5da5232db6155f31ea800fa混淆会员编码
termiTypeStringYPC终端类型:PC:计算机;M-phone:移动手机;TV:电视;Watch:手表;Auto:汽车
appIdStringNnl87eipc8psd706ukbuiu8402微信应用id
termiSysStringYIOS终端系统(Windows系统:Windows Linux系统:Linux Mac系统:Macos 安卓系统:Android IOS系统:IOS 鸿蒙系统:HarmonyOS)
dfpTokenStringYTHc0gl1713dc37bc5gJJx2a58设备token
inviteSnUnionIdStringN5232db605f31ea8f0fa13eeda5da5232db6155f31ea800fa邀请人混淆会员编号
appTypeStringY3native:原生;browser:浏览器;mini-program:小程序
giftPickTypeStringN0奖品领取方式0:自动发;1手动领
referenceURLStringNhttp://osposxgpre.admin.cnsuning.com/osposadmin/aplcf/toalconf.do当前页面地址
detectStringYmmds_97fc62e6ea2c41abf7745f51622c67b3人机参数
tokenStringNTHE0Kg17157544d8fsIFbb0d0___w7DDp8KLw75ow5MZbMOyImjCqsONBcOFw7hawqrCssOg验证码token(返回参数resultFlag为3时必传)
miniSourceStringNwechatsuning:苏宁;toutiao:头条;wechat:微信;baidu:百度;quickapp:快应用;qq:QQ;alipay:支付宝;douyin:抖音
serialNoStringNsnyg612_39eaf0e06bbc54c387425bd94990f80c事件流水号(返回参数resultFlag为3时必传)
valiNoStringN6002318564154563465业务唯一标识(返回参数resultFlag为3时必传)
appVersionStringNV12.2.12APP外版本号,PC,WAP传空值
cutOrderNumStringN20050516554033782968助力团编号
activityCodeStringY20050516554033782968星河营销活动编码
响应参数
名称 类型 示例值 描述
resultFlagString0 失败 1 成功 3 验证token操作结果
failMessageString风控拦截失败信息
serialNoStringsnyg612_39eaf0e06bbc54c387425bd94990f80c事件流水号
valiNoString6002318564154563465业务唯一标识
ticketString07d348ef6813d27fdc6ec9c57f64f98dd49a50dbb1ee0a66999b88b701db0d4590a98b02a55c7a20272c6d8a19c8b7858454582bcb6a5acf验证码ticket
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <queryActionrisk>
      <appVersion>V12.2.12</appVersion>
      <termiSys>IOS</termiSys>
      <dfpToken>THc0gl1713dc37bc5gJJx2a58</dfpToken>
      <detect>mmds_97fc62e6ea2c41abf7745f51622c67b3</detect>
      <miniSource>wechat</miniSource>
      <cutOrderNum>20050516554033782968</cutOrderNum>
      <valiNo>6002318564154563465</valiNo>
      <snUnionId>5232db605f31ea8f0fa13eeda5da5232db6155f31ea800fa</snUnionId>
      <serialNo>snyg612_39eaf0e06bbc54c387425bd94990f80c</serialNo>
      <token>THE0Kg17157544d8fsIFbb0d0___w7DDp8KLw75ow5MZbMOyImjCqsONBcOFw7hawqrCssOg</token>
      <referenceURL>http://osposxgpre.admin.cnsuning.com/osposadmin/aplcf/toalconf.do</referenceURL>
      <actionType>1</actionType>
      <activityCode>20050516554033782968</activityCode>
      <appType>3</appType>
      <appId>nl87eipc8psd706ukbuiu8402</appId>
      <termiType>PC</termiType>
      <inviteSnUnionId>5232db605f31ea8f0fa13eeda5da5232db6155f31ea800fa</inviteSnUnionId>
      <giftPickType>0</giftPickType>
    </queryActionrisk>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "queryActionrisk": {
        "appVersion": "V12.2.12",
        "termiSys": "IOS",
        "dfpToken": "THc0gl1713dc37bc5gJJx2a58",
        "detect": "mmds_97fc62e6ea2c41abf7745f51622c67b3",
        "miniSource": "wechat",
        "cutOrderNum": "20050516554033782968",
        "valiNo": "6002318564154563465",
        "snUnionId": "5232db605f31ea8f0fa13eeda5da5232db6155f31ea800fa",
        "serialNo": "snyg612_39eaf0e06bbc54c387425bd94990f80c",
        "token": "THE0Kg17157544d8fsIFbb0d0___w7DDp8KLw75ow5MZbMOyImjCqsONBcOFw7hawqrCssOg",
        "referenceURL": "http://osposxgpre.admin.cnsuning.com/osposadmin/aplcf/toalconf.do",
        "actionType": "1",
        "activityCode": "20050516554033782968",
        "appType": "3",
        "appId": "nl87eipc8psd706ukbuiu8402",
        "termiType": "PC",
        "inviteSnUnionId": "5232db605f31ea8f0fa13eeda5da5232db6155f31ea800fa",
        "giftPickType": "0"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <queryActionrisk>
      <ticket>07d348ef6813d27fdc6ec9c57f64f98dd49a50dbb1ee0a66999b88b701db0d4590a98b02a55c7a20272c6d8a19c8b7858454582bcb6a5acf</ticket>
      <resultFlag>0 失败 1 成功 3 验证token</resultFlag>
      <valiNo>6002318564154563465</valiNo>
      <failMessage>风控拦截</failMessage>
      <serialNo>snyg612_39eaf0e06bbc54c387425bd94990f80c</serialNo>
    </queryActionrisk>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "queryActionrisk": {
        "ticket": "07d348ef6813d27fdc6ec9c57f64f98dd49a50dbb1ee0a66999b88b701db0d4590a98b02a55c7a20272c6d8a19c8b7858454582bcb6a5acf",
        "resultFlag": "0 失败 1 成功 3 验证token",
        "valiNo": "6002318564154563465",
        "failMessage": "风控拦截",
        "serialNo": "snyg612_39eaf0e06bbc54c387425bd94990f80c"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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