配置下发接口V4
2023.05.08 17:12:05
接口说明
当客户端出现风控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
}
响应返回码
响应返回码见:响应返回码