接口说明

提供查询服务，服务端可通过调用该接口获取同一个角色ID登录的模拟器设备在24小时内登录的所有角色ID。

鉴权说明

易盾智能风控服务使用签名认证方法对接口进行鉴权，所有接口每一次请求都需要包含签名信息（signature 参数），以验证用户身份，防止信息被恶意篡改。目前支持MD5签名算法，详细信息请参见接口鉴权。

接入须知

• 查询频率限制
  • 控制接口调用频率，查询频率过快可能会被拒绝，拒绝后稍后重试即可
  • 建议两次查询间隔为10s以上

 

请求说明

请求地址

名称	值
HTTP URL	http://ir-open.dun.163.com/v5/group/getGroup
HTTP Method	POST

请求头

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

请求参数

请求参数分为：公共参数，接口参数。其中，公共参数请见公共请求参数；接口参数如下：

参数	类型	必填	描述
roleId	String	是	需要查询的角色id

请求参数示例

{
    "businessId": "xxx966f73yyy59440583zzz9bfcc79df",
    "secretId": "nnn966f73yyy59440583zzz9bfcc79dc",
    "timestamp": ${currentTimeMs},
    "nonce": "mmm888f73yyy59440583zzz9bfcc79de",
    "version": "500",
    "signature": "lll888f73yyy59440583zzz9bfcc79da",
    "roleId": "roleId001"
}

响应

响应结果

响应数据格式为：JSON。

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

参数	类型	描述
code	Integer	响应码，正常情况下为200，异常时，见 附录响应码定义
msg	String	响应码说明，正常情况下返回“ok”，异常时，见 附录响应码定义
data	Array<RoleInfoData>	RoleInfoData数据格式， 如下

RoleInfoData数据格式：

参数	类型	说明
roleId	String	登录同一设备的角色ID
uploadTime	Long	十位时间戳，精度是秒
dataSource	Integer	客户端上报的数据来源类型，3表示登录上报

响应结果示例

{
    "code": 200,
    "msg": "ok!",
    "data": [
        {
          "roleId": "role1_xxxxxx",
          "uploadTime": 1661323413,
          "dataSource": 3
        },
        {
          "roleId": "role2_xxxxxx",
          "uploadTime": 1661323413,
          "dataSource": 3
        }
  ],
  "ok":true
}

响应返回码

响应返回码见：响应返回码