## 接口说明

本接口用于查询图像外挂识别接口的检测结果。

### 鉴权说明

易盾智能风控服务使用签名认证方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5签名算法，详细信息请参见[接口鉴权](https://support.dun.163.com/documents/761315885761396736?docId=771165928044277760)。

### 接入须知

因取证信息场景复杂，为了保障封禁动作依据完备，如需封号，建议结合用户/玩家的业务数据进行二次判断，或者与易盾技术人员进行二次确认，以确保准确无误。请控制接口调用频率，频率过高，可能会超过频率限制，导致查询失败，建议QPS不超过10。

## 单条查询请求说明

### 请求地址

| 名称        | 值                                                           |
| ----------- | ------------------------------------------------------------ |
| HTTP URL    | [http://ir-open.dun.163.com/v5/risk/mediaQuery](http://ir-open.dun.163.com/v5/risk/mediaQuery) |
| HTTP Method | POST                                                         |

### 请求头
| 名称         | 类型   | 必填 | 描述                                    |
| ------------ | ------ | ---- | --------------------------------------- |
| Content-Type | String | 是   | 固定值："Content-Type:application/json" |


 
### 请求参数

请求参数分为：公共参数，接口参数。其中，公共参数请见[公共请求参数](https://support.dun.163.com/documents/761315885761396736?docId=771155891167080448)；接口参数如下：


| 参数      | 类型   | 必填 | 描述                                                         |
| --------- | ------ | ---- | :----------------------------------------------------------- |
| taskId    | String | 是   | 检测任务 ID                                  |


 
### 请求参数示例

```java
{
    "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
    "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp": ${currentTime},
    "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
    "version": "500",
    "signature": "lll888f73yyy59440583zzz9bfcc79da",
    "taskId":  "e6ewxylcm62kh1a7yra3hxdgdd00a7p4"
}
```
## 响应

### 响应结果

响应数据格式为：JSON。

响应头为：Content-Type: application/json，具体如下：

| 参数 | 类型       | 描述                                                         |
| ---- | ---------- | ------------------------------------------------------------ |
| code | Integer    | 响应码，正常情况下为200，异常时，见 [附录响应码定义](https://support.dun.163.com/documents/761315885761396736?docId=771158735672750080) |
| msg  | String     | 响应码说明，正常情况下返回"成功"，异常时，见 [附录响应码定义](https://support.dun.163.com/documents/761315885761396736?docId=771158735672750080) |
| ok | Boolean | 请求是否成功，true=成功 |
| desc | String     | 响应信息描述，非必返，常见错误情况下会返回错误说明或错误参考文档                                                                                    |
| data | JSONObject | 返回数据，格式下表说明                                       |

返回数据的格式：

| 参数          | 类型      | 说明                      |
|-------------|---------|-------------------------|
| receiveTime | Long    | 请求收到时间                  |
| ip          | String  | 用户/玩家的IP                |
| roleId      | String  | 用户/玩家的角色ID              |
| nickname    | String  | 用户/玩家的昵称                |
| server      | String  | 用户/玩家的角色的服务器名称          |
| status      | Integer | 检测状态：-1:未检测， 0:正常， 1:异常 |
| tagNameList | List<String> | 命中标签名称列表                |
| reason      | String  | 详情                      |

### 响应结果示例

* 识别结果正常时：
```java
{
    "code": 200,
    "msg": "成功",
    "data": 
        {
            "receiveTime": 1715531484738,
            "ip": "1.1.1.1",
            "roleId": "mediaRoleId01",
            "nickname": "mediaNickName01",
            "server": "mediaServer01",
            "status": 1,
            "tagNameList": ["外挂嫌疑","外挂软件"],
            "reason": "reason01"
        },
        "ok": true
}
```


## 批量查询请求说明

### 请求地址

| 名称        | 值                                                           |
| ----------- | ------------------------------------------------------------ |
| HTTP URL    | [http://ir-open.dun.163.com/v5/risk/mediaBatchQuery](http://ir-open.dun.163.com/v5/risk/mediaBatchQuery) |
| HTTP Method | POST                                                         |

### 请求头
| 名称         | 类型   | 必填 | 描述                                    |
| ------------ | ------ | ---- | --------------------------------------- |
| Content-Type | String | 是   | 固定值："Content-Type:application/json" |


&nbsp;
### 请求参数

请求参数分为：公共参数，接口参数。其中，公共参数请见[公共请求参数](https://support.dun.163.com/documents/761315885761396736?docId=771155891167080448)；接口参数如下：


| 参数      | 类型     | 必填 | 描述                          |
| --------- |--------| ---- |:----------------------------|
| taskIds    | String | 是   | 检测任务 ID 列表json字符串，单次最多传入100个taskId |


&nbsp;
### 请求参数示例

```java
{
    "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
    "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp": ${currentTime},
    "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
    "version": "500",
    "signature": "lll888f73yyy59440583zzz9bfcc79da",
    "taskIds": "[\"tpavc9q43b0ihy5ekc5g2axgdd00aaxs\",\"1ggpjkqx07qoopc35w8b2ybgdd00aaxs\"]"
}
```
## 响应

### 响应结果

响应数据格式为：JSON。

响应头为：Content-Type: application/json，具体如下：

| 参数 | 类型      | 描述                                                                                                                   |
| ---- |---------|----------------------------------------------------------------------------------------------------------------------|
| code | Integer | 响应码，正常情况下为200，异常时，见 [附录响应码定义](https://support.dun.163.com/documents/761315885761396736?docId=771158735672750080)     |
| msg  | String  | 响应码说明，正常情况下返回”成功”，异常时，见 [附录响应码定义](https://support.dun.163.com/documents/761315885761396736?docId=771158735672750080) |
| ok | Boolean | 请求是否成功，true=成功 |
| desc | String  | 响应信息描述，非必返，常见错误情况下会返回错误说明或错误参考文档                                                                                     |
| data | Array\<DetailData>  | 返回的每条数据详情内容同单条查询接口                                                                                                   |


### 响应结果示例

* 识别结果正常时：
```java
{
        {
        "code": 200,
        "msg": "成功",
        "data": [
            {
                "receiveTime": 1715531484738,
                "ip": "1.1.1.1",
                "roleId": "mediaRoleId01",
                "nickname": "mediaNickName01",
                "server": "mediaServer01",
                "status": 1,
                "tagNameList": ["外挂嫌疑","外挂软件"],
                "reason": "reason01"
            },
            {
                "receiveTime": 1715531484738,
                "ip": "1.1.1.1",
                "roleId": "mediaRoleId02",
                "nickname": "mediaNickName02",
                "server": "mediaServer02",
                "status": 1,
                "tagNameList": ["外挂嫌疑","外挂软件"],
                "reason": "reason02"
            }
        ],
        "ok": true
        }
}
```


**注意事项**

- 当查询频率过高返回超出限流时，可稍后再次重试。
- 当返回无数据时，可能原因包括数据不存在，或数据超过当前默认一个月的留存周期。
- 自动封禁有风险，操作请谨慎，建议参考其他因素综合考虑。

### 响应返回码

响应返回码见：[响应返回码](https://support.dun.163.com/documents/761315885761396736?docId=771158735672750080)。