接口用途

本接口用于验证角色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时，如果返回无数据，则确认是数据不存在。
• 自动封禁有风险，操作请谨慎，建议综合参考其它因素。