同设备用户信息查询
2024.07.09 11:03:55
接口用途
提供查询服务,服务端可通过调用该接口获取同一个角色ID登录的模拟器设备在24小时内登录的所有角色ID。
接入须知
控制接口调用频率,频率过高,可能会超过频率限制,导致查询失败,建议间隔1分钟以上;最大查询1w条记录。
使用形式
-
接口地址:http://open-yb.dun.163.com/api/open/v1/group/getGroup
-
请求方法:POST
-
请求头:Content-Type:application/json
请求参数
- 请求参数:包括公共参数,和接口参数
- 见请求公共参数
- 接口参数如下:
参数名称 | 类型 | 必须 | 最大长度 | 描述 |
---|---|---|---|---|
roleId | String | 是 | 256 | 需要查询的角色ID |
请求参数示例(包括公共参数)
{
"appId": "xxxx",
"timestamp":${currentTime},
"nonce":111,
"token": "${sign}",
"roleId": "role1_xxxxxx"
}
响应结果
响应数据格式:JSON
- 响应头为:Content-Type: application/json
名称 | 类型 | 描述 |
---|---|---|
code | Integer | 响应码,正常情况时为200,异常时,见响应返回码 |
msg | String | 响应码说明,正常时返回ok,异常时,见响应返回码 |
data | Array<RoleInfoData> | 调用成功时会有该字段返回,该字段的数据结构,见roleInfo数据结构 |
参数名 | 类型 | 描述 |
---|---|---|
roleId | String | 登录同一设备的角色id |
loginTime | String | 登录同一设备的角色id的最早一次登录时间 |
响应数据示例
- 正常数据示例
{
"code": 200,
"msg": "OK",
"data": [
{
"roleId": "role1_xxxxxx",
"loginTime": 1661323413000
},
{
"roleId": "role2_xxxxxx",
"loginTime": 1661323413000
},
{
"roleId": "role3_xxxxxx",
"loginTime": 1661323413000
},
{
"roleId": "role4_xxxxxx",
"loginTime": 1661323413000
}
],
"lastestEventTime": 0
}
- 异常数据示例
{
"msg": "未授权或者授权已过期",
"code": 401
}