接口用途

本接口用于反外挂嫌疑数据在线检测。

接入须知

注意事项：因取证信息场景复杂，为了保障封号依据完备，如需封号，建议结合角色的业务数据进行二次判断或者和易盾技术人员进行二次确认，以确保准确无误

使用形式

• 接口地址：http://open-yb.dun.163.com/api/open/v1/risk/doubtful/check

• 请求方法：POST

• 请求头：Content-Type：application/json

请求参数

• 请求参数：包括公共参数和接口参数
  • 见请求公共参数
  • 接口参数如下：

名称	类型	是否必填	描述
mrData	String	是	嫌疑上报数据，游戏方需要从反外挂客户端SDK获取该数据。查看反外挂客户端SDK接入文档，请联系易盾获取。 《网易易盾手游智能反外挂（Android-java）接入文档》， 查看通用查询函数,传入参数Cmd_GetCollectData = 8; 《网易易盾手游智能反外挂(iOS-OC)接入文档》查看数据查询函数
ip	String	否	玩家的IP
roleId	String	是	角色ID
roleName	String	否	角色名称
roleServer	String	否	服务器
roleAccount	String	否	角色账号
gameJson	String	否	游戏上传信息，游戏方可以自己构建json结构
extData	String	否	额外信息，游戏方可以自己构建json结构，最大长度：2048

gameJson字段说明：

名称	类型	是否必填	描述
GameVersion	String	否	游戏版本号
AssetVersion	String	否	资源版本号

请求参数示例（包括公共参数）

{
    "appId": "xxx8888888",
    "timestamp": ${currentTime},
    "nonce": "1111111",
    "token": "${sign}",
    "mrData":  "xxxxxxx",
    "ip":  "1.1.1.1",
    "roleId":  "yyyyyyy",
    "roleName":  "yyyyyyy",
    "roleServer":  "yyyyyyy",
    "roleAccount":  "yyyyyyy",
    "gameJson": "{\"GameVersion\":\"1.0.2\", \"AssetVersion\":\"0.2.1\"}",
    "extData": "zzzzzzz"
}

响应结果

响应数据格式：JSON

• 响应头为：Content-Type: application/json

参数名称	类型	描述
code	Integer	响应码，正常情况时为200，异常时，见响应返回码
msg	String	响应码说明，正常时返回ok，异常时，见响应返回码
data	Object	返回数据，格式见【检测结果的数据格式】

• 检测结果的数据格式：

名称	类型	描述
action	Integer	建议执行动作：0 正常(放行)，10 异常(闪退)
hitInfos	List	命中风险信息，例如：[{"tag1Id":"一级Id","tag1Name":"一级名称","tag2Id":"二级Id","tag2Name":"二级名称","tag3Id":"三级Id","tag3Name":"三级名称"}]， 其中, tag1Id类型为String，含义是命中一级输出标识Id， tag1Name类型为String，含义是命中一级输出标识名称； tag2Id类型为String，含义是命中二级输出标识Id， tag2Name类型为String，含义是命中二级输出标识名称； tag3Id类型为String，含义是命中三级输出标识Id， tag3Name类型为String，含义是命中三级输出标识名称； 如果同时命中多个类型，则会返回所有风险信息

响应结果示例

• 嫌疑数据识别为正常的响应结果：

  {
    "code": 200,
     "msg": "ok!",
     "data": {
         "action": 0,
         "hitInfos": null        
    }
    
  }

• 嫌疑数据被识别为异常的响应结果：

  {

    "code": 200,
    "msg":"ok!",
    "data": {
        "action": 10,
         "hitInfos": [
             {"tag1Id":"一级Id","tag1Name":"一级名称","tag2Id":"二级Id","tag2Name":"二级名称","tag3Id":"三级Id","tag3Name":"三级名称"}
         ]
    }
  }

注意：

• 当返回无数据时，数据处理可能存在延时或者数据不存在。
• 自动封禁有风险，操作请谨慎，建议综合参考其他因素。