同设备用户信息查询

2024.03.14 20:19:08

    接口用途

    提供查询服务,服务端可通过调用该接口获取同一个角色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数据结构
    • RoleInfoData数据结构如下:
    参数名 类型 描述
    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 
    } 
    
    Online Chat Tel:95163223 Free trial