根据时间段批量查询反外挂详情接口

2024.06.20 14:37:11

    接口用途

    本接口用于根据时间段批量查询反外挂详情。

    接入须知

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

    使用形式

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

    • 请求方法:POST

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

    请求参数

    • 请求参数:包括公共参数和接口参数
    名称 类型 是否必填 描述
    nextFlag array 1. 第一次查询时,该字段填充null或者""
    2. 当某个查询条件返回数据大于5000条,则需要分批返回数据,表示下一批数据起始标记。3. 当nextFlag数组返回为空时,表示数据都已经返回,不需要继续执行下一批查询
    beginDateTime long 查询开始时间 ,单位毫秒(只支持最近一个月)
    endDateTime long 查询结束时间(不包含),单位毫秒(结束时间-开始时间<24小时,不填写默认开始时间加24小时)

    注意事项:

    当某个查询条件返回数据大于5000条,需要保持beginDateTime、endDateTime查询条件不变,更新nextFlag值获得剩余的数据

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

    {
    	"appId":"W009887949",
    	"timestamp":"${currentTime}",
    	"token":"${sign}",
    	"nonce":"111",
    	"beginDateTime":1606701600000,
    	"endDateTime":1606730400000,
    	"nextFlag":[1606717845085, "2020-11-30-ff5fccf4516c1e7a19bd61d8dff6a246"]
    }
    

    响应结果

    响应数据格式:JSON
    • 响应头为:Content-Type: application/json
    参数名称 类型 描述
    code Integer 响应码,正常情况时为200,异常时,见响应返回码
    msg String 响应码说明,正常时返回ok,异常时,见响应返回码
    data Object 返回数据,格式见【结果的数据格式】
    • Data的数据示例
      {
      	"nextFlag":[1602642310996, "2020-10-14-7eddcf0facecda658b92e0a44dfa76e3"],
      	"total":100004,
      	"pcData":[]
      }
    
    • nextFlag: 如果total大于5000条,则会返回nextFlag,下一次查询需要附带上次查询返回的nextFlag。当nextFlag返回[],代表所有符合条件数据已经查询完毕。
    • total: 符合查询条件的数据总量
    • pcData: 查询返回的具体数据。字段解释如下:
    名称 类型 描述
    createTime Long 入库时间
    deviceId String 设备Id
    envDetection Array 环境检测结果
    featureContent String 证据内容
    featureDesc String 证据描述
    level Integer 玩家游戏等级
    mac Long 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 传输方式
    protectionResult String 防护结果

    响应结果示例

    • 正常的响应结果:
     {
    	"code":200,
    	"data":{
    	"nextFlag":[1602642310996, "2020-10-14-7eddcf0facecda658b92e0a44dfa76e3"],
    	"total":100004,
    	"pcData":
    		[{
    		"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":"客户端直传"},
    		"protectionResult":"防护成功"
    		]
    		},
    	"msg":"ok"
    }
    
    • 异常的响应结果:
      {
        "code":4401,
        "msg":"Token验证失败"
    	}
    
    Online Chat Tel:95163223 Free trial