根据时间段批量查询反外挂详情接口
2024.07.09 11:03:55
接口用途
本接口用于根据时间段批量查询反外挂详情。
接入须知
注意事项:因取证信息场景复杂,为了保障封号依据完备,如需封号,建议结合角色的业务数据进行二次判断或者和易盾技术人员进行二次确认,以确保准确无误。
使用形式
-
接口地址: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验证失败"
}