接口说明

当客户端出现风控SDK接口被屏蔽，获取不到业务配置信息时（如初始化功能配置、特征配置等），可通过此接口获取业务配置信息，并下发到客户端完成配置。

鉴权说明

易盾智能风控服务使用签名方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5，SHA1，SHA256，SM3几种加密算法，详细信息，请参见接口鉴权。

接入须知

• 请控制接口调用频率，频率过高，可能会超过频率限制，导致查询失败（建议1个玩家最快3分钟请求1次）。

 

请求说明

请求地址

名称	值
HTTP URL	http://ir-open.dun.163.com/v4/risk/getConfig
HTTP Method	POST

请求头

名称	类型	必填	描述
Content-Type	String	是	固定值："Content-Type:application/json"

 

请求参数

请求参数分为：公共参数，接口参数。其中，公共参数请见公共请求参数；接口参数如下：

参数	类型	必填	描述
ip	String	是	用户/ 玩家的IP，或当前客户端业务事件发生时的公网IP地址（ipv4）
sdkData	String	否	从风控SDK获取的拉取配置的参数

 

请求参数示例

{
    "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
    "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp": ${currentTime},
    "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
    "version": "400",
    "signature": "lll888f73yyy59440583zzz9bfcc79da",
    "ip":  "1.1.1.1",
    "sdkData": "..."
}

//其中，配置下发接口，参与签名验证计算的参数如下
{
    //公共参数
    "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
    "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp": ${currentTime},
    "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
    "version": "400",
    //业务参数
    "ip":  "1.1.1.1",
    "sdkData": "..."
}

响应

响应结果

响应数据格式为：JSON。

响应头为：Content-Type:application/json，具体如下：

参数	类型	描述
code	Integer	响应码，正常情况下为200，异常时，见 附录响应码定义
msg	String	响应码说明，正常情况下返回“ok”，异常时，见 附录响应码定义
desc	String	响应信息描述，非必返，常见错误情况下会返回错误说明或错误参考文档
data	JSONObject	返回数据，格式下表说明

返回数据格式：

参数	类型	说明
configData	String	配置参数加密数据，应用/游戏方可转交给风控 sdk 解析处理。

响应结果示例

• 获取结果正常时：

{
    "code": 200,
    "msg": "ok!",
    "data": {
        "configData": "xxxxxxxx"
    },
    "ok":true
}

响应返回码

响应返回码见：响应返回码