员工身份(EIAM)
查询公共账号使用者
接口
# 权限
身份管理API是以应用维度授权的,在调用接口前需为不同的应用设置接口权限,详情请参考API权限。
权限代码 | 描述 |
---|---|
account_all | 账户管理接口的读写权限 |
account_read | 账户管理接口的读权限 |
all | 全部接口读写权限 |
read | 所有读接口的权限 |
# 请求说明
GET https://{your_domain}/api/v2/tenant/applications/{app_id}/accounts/public-account/{app_user_id}/users?offset=0&limit=10
# 请求头
参数名 | 中文名称 | 必须 | 类型 | 描述 |
---|---|---|---|---|
Authorization | 授权 | 是 | String | 格式:Bearer {access_token} |
Content-Type | 内容类型 | 是 | String | 固定值:application/json; charset=utf-8 |
# 请求示例
无
# 请求参数
参数名 | 中文名称 | 必须 | 类型 | 描述 |
---|---|---|---|---|
app_id | 应用ID | 是 | String | 目标应用id |
app_user_id | 应用账号ID | 是 | String | |
offset | 分页页码 | 是 | Int | 从第0页开始 |
limit | 每页数量 | 是 | Int | 每页数量在10-100之间 |
# 返回示例
正确示例:
HTTP/1.1 200 OK
{
"total": 1,
"associated_users": [
{
"id": "20220331164602949-904C-D475B60AE",
"userName": "zhangsan",
"disabled": false
}
]
}
错误示例:
HTTP/1.1 400 Bad Request
{
"error_code": " APP.ACCOUNT.0038",
"error_msg": "公共账号不存在"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 返回参数
参数名 | 中文名称 | 类型 | 描述 |
---|---|---|---|
total | 总数 | Int | |
associated_users | 用户集合 | List | |
-- id | 用户ID | String | |
-- userName | 用户名 | String | |
-- disabled | 是否禁用 | Boolean |
# 错误码
状态码 | 错误码 | 错误信息 | 处理措施 |
---|---|---|---|
400 | APP.ACCOUNT.0038 | 公共账号不存在 | 请检查公共账号是否存在 |
Public account does not exist | |||
400 | OAP.PAGE.0002 | 分页参数超过限制 | 请检查分页参数是否正确 |
Pagination parameter exceeds limit |