同设备用户信息查询接口

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数据格式, 如下

    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
    }
    

    响应返回码

    响应返回码见:响应返回码

    Online Chat Tel:95163223 Free trial