按玩家信息条件查询反外挂详情接口

2024.06.20 14:37:11

    接口用途

    本接口用于按玩家信息条件查询反外挂详情。

    接入须知

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

    使用形式

    • 接口地址:http://open-yb.163yun.com/api/open/v1/pc/list

    • 请求方法:POST

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

    请求参数

    • 请求参数:包括公共参数和接口参数

    名称 类型 是否必填 描述
    deviceId String 设备Id
    roleId String 角色Id
    roleName String 角色名称
    userAccount String 用户账号
    beginDateTime Long 查询开始时间 ,单位毫秒(只支持最近一个月)
    endDateTime Long 查询结束时间(不包含),单位毫秒(结束时间-开始时间<24小时,不填写默认开始时间加24小时)

    注意事项:

    1)接口参数deviceId、roleId、roleName、userAccount 在查询条件中,至少选填一个。

    2)控制接口调用频率,频率过高,可能会超过频率限制,导致查询失败。建议间隔大于10s。

    请求参数示例(包括公共参数)

    {
    	"appId":"W009887949",
    	"timestamp":"${currentTime}",
    	"token":"${sign}",
    	"nonce":"111",
    	"beginDateTime":1564041324000,
    	"endDateTime":1574127724519,
    	"roleId":"00992755211_11", 
    	"deviceId": "",
    	"userAccount": "",
    	"roleName": ""
    }
    
    

    响应结果

    响应数据格式:JSON
    • 响应头为:Content-Type: application/json
    参数名称 类型 描述
    code Integer 响应码,正常情况时为200,异常时,见响应返回码
    msg String 响应码说明,正常时返回ok,异常时,见响应返回码
    data Array[RiskData] 返回数据,RiskData类型结构如下
    • RiskData类型结构:
    名称 类型 描述
    createTime Long 入库时间
    deviceId String 设备Id
    envDetection Array 环境检测结果
    featureContent String 证据内容
    featureDesc String 证据描述
    level Integer 玩家游戏等级
    mac String MAC地址
    matchRuleName Array 命中规则名称
    plugs Array 外挂检测结果
    riskDetection Array 风险检测结果
    roleId String 角色ID
    roleName String 角色名称
    serverId Integer 服务器ID
    serverName String 服务器名称
    userAccount String 游戏账号
    clientVersion String 客户端版本
    defenseResult String 防御结果
    ip String 客户端IP
    trans String 传输方式

    响应结果示例

    • 正常的响应结果:
      {
        "code":200,
        "data":[
            {
                "createTime":1602673073516,
                "deviceId":"330022551144889914",
                "envDetection":[
                    "yl应用环境A三级-PCHJ.yl.S2"
                ],
                "featureContent":"22112233445566778899002233445511",
                "featureDesc":"lua提取修改器.exe",
                "level":89,
                "mac":"00:05:28:90:80:00:1e",
                "matchRuleName":[
                    "yl应用规则PC-S",
                    "yl风险规则PC-S"
                ],
                "plugs":[
                    "yl外挂A-PCWG.yl.T1"
                ],
                "riskDetection":[
                    "yl风险二级-PCFX.yl.S2"
                ],
                "roleId":"00992755211_11",
                "roleName":"全能骑士-DT",
                "serverId":10086,
                "serverName":"军团-DT",
              "userAccount":"ylTestxxx@126.com",
              "clientVersion":"10010",
              "ip":"127.0.0.1",
              "defenseResult":"拦截成功",
              "trans":"客户端直传"
            }
        ],
        "msg":"ok"
    }
    
    • 异常的响应结果:
     {
        "code":4401,
        "msg":"Token验证失败"
    }
    
    Online Chat Tel:95163223 Free trial