同设备用户信息查询接口
2024.10.21 16:31:15
接口说明
提供查询服务,服务端可通过调用该接口获取同一个角色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数据格式, 如下 |
参数 | 类型 | 说明 |
---|---|---|
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
}
响应返回码
响应返回码见:响应返回码