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