文档首页/ 应用身份管理服务 OneAccess/ API参考/ API/ 管理类接口/ 应用账号管理/ 查询应用账号列表
更新时间：2024-08-30 GMT+08:00
查看PDF
分享

查询应用账号列表

功能介绍

查询一个应用被授权访问的账号列表。

接口约束

无

URI

GET /api/v2/tenant/applications/{application_id}/accounts

表1 路径参数

参数

是否必选

参数类型

描述

application_id

是

String

应用id。
表2 Query参数

参数

是否必选

参数类型

描述

account_type

否

String

账号类型，固定值，普通应用账号（BASIC_ACCOUNT），孤儿账号（ORPHAN_ACCOUNT），公共账号（PUBLIC_ACCOUNT）,不填查询所有。

offset

是

Integer

第几页。

最小值：0

limit

是

Integer

每页多少条。

最小值：10

最大值：100

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

total

Long

应用账号总数。

accounts

Array of AccountDetail objects

响应的用户列表。
表5 AccountDetail

参数

参数类型

描述

id

String

应用账号id。

account_name

String

应用账号名。

account_type

String

应用账号类型。

name

String

姓名。

disabled

Boolean

是否禁用。

org_id

String

应用机构id。

roles

Array of RolesInfo objects

角色信息。

extension

Object

自定义扩展属性。
表6 RolesInfo

参数

参数类型

描述

role_id

String

角色id。

role_code

String

角色代码。

role_name

String

角色名称。

privileges

Array of PrivilegeInfo objects

权限集合。
表7 PrivilegeInfo

参数

参数类型

描述

privilege_id

String

权限ID。

privilege_code

String

权限代码。

privilege_name

String

权限名称。

resource_items

Array of ResourceItem objects

资源条目集合。
表8 ResourceItem

参数

参数类型

描述

item_id

String

条目ID。

item_code

String

条目代码。

item_name

String

条目名称。

item_parentid

String

父条目ID。

状态码： 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

根据应用id分页查询应用下的普通应用账号列表，返回查询结果的前100条数据，如不满100条，则返回实际数量的结果。

GET https://{domain_name}/api/v2/tenant/applications/{application_id}/accounts?account_type=BASIC_ACCOUNT&offset=0&limit=100

Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...

响应示例

状态码： 200

请求成功。

{
  "total" : 1,
  "accounts" : [ {
    "id" : "20210621095850460-5A8A-03D94B540",
    "account_name" : "Test01",
    "account_type" : "BASIC_ACCOUNT",
    "name" : "Example01",
    "disabled" : false,
    "org_id" : "20210621095942194-560B-57E3CC...",
    "extension" : { }
  } ]
}

状态码

状态码

描述

200

请求成功。

400

参数无效。

错误码

请参见错误码。

父主题： 应用账号管理

相关文档