接口用途

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

接入须知

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

使用形式

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