反外挂嫌疑在线检测

2024.07.09 11:03:55

    接口用途

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

    接入须知

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

    使用形式

    • 接口地址: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":"三级名称"}
             ]
        }
      }
    

    注意:

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