接口用途

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

接入须知

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

使用形式

• 接口地址：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验证失败"
	}