反外挂角色ID存在验证
2024.07.09 11:03:55
接口用途
本接口用于验证角色ID,是否存在嫌疑上报数据中。支持批量验证。
接入须知
注意事项:因取证信息场景复杂,为了保障封号依据完备,如需封号,建议结合角色的业务数据进行二次判断或者 和易盾技术人员进行二次确认,以确保准确无误 ;控制接口调用频率,频率过高,可能会超过频率限制,导致查询失败,建议间隔10s。
使用形式
-
接口地址:http://open-yb.dun.163.com/api/open/v1/risk/doubtful/checkroleidexist
-
请求方法:POST
-
请求头:Content-Type:application/json
请求参数
- 请求参数:包括公共参数和接口参数
- 见请求公共参数
- 接口参数如下:
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
beginTime | Long | 是 | 开始时间,单位毫秒 |
endTime | Long | 是 | 结束时间,单位毫秒 |
roleIds | Array<String> | 是 | 数组最大个数:100 |
请求参数示例(包括公共参数)
{
"appId": "xxx8888894",
"timestamp": ${currentTime},
"nonce":111,
"token": "${sign}",
"roleIds": ["roleTestid","roleTestid2","TransTest"],
"beginTime":1575388800000,
"endTime": 1585545601000
}
响应结果
-
响应数据格式:JSON
- 响应头为:Content-Type: application/json
参数名称 | 类型 | 描述 |
---|---|---|
code | Integer | 响应码,正常情况时为200,异常时,见响应返回码 |
msg | String | 响应码说明,正常时返回ok,异常时,见响应返回码 |
data | RoleInfo | 返回数据,格式见【RoleInfo数据格式】 |
lastestEventTime | Long | 不为默认值0时,表示可供查询数据的最新时间 |
- RoleInfo数据格式:
名称 | 类型 | 描述 |
---|---|---|
total | Integer | 返回记录条数,去重 |
roleIds | Array<String> | 记录明细 |
响应结果示例
-
存在角色ID时:
{ "code": 0, "msg": null, "data": { "total": 2, "roleIds": [ "TransTest", "roleTestid" ] }, "lastestEventTime": 0 }
-
当不存在角色ID时:
{ "code": 0, "msg":"当前查询条件无数据返回,可能因为数据不存在或者数据处理未完成,可供查询数据的最新时间见lastestEventTime字段。", "data": { "total": 0, "roleIds": [] }, "lastestEventTime": 1578366604897 }
注意:
- 当返回无数据时,数据处理可能存在延时或者数据不存在。
- 当设置查询的结束时间endTime小于lastestEventTime时,如果返回无数据,则确认是数据不存在。
- 自动封禁有风险,操作请谨慎,建议综合参考其它因素。