竹云IDaaS•开放平台
员工身份(EIAM)

获取应用机构信息

接口

# 权限

身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。

权限代码 描述
app_org_all 应用机构管理接口的读写权限
app_org_read 应用机构管理接口的读权限
all 全部接口读写权限
read 所有读接口的权限

# 请求说明

GET https://{your_domain}/api/v2/tenant/applications/{app_id}/organizations/{app_org_id}

# 请求头

参数名 中文名称 必须 类型 描述
Authorization 授权 是 String 格式：Bearer {access_token}
Content-Type 内容类型 是 String 固定值：application/json; charset=utf-8

# 请求示例

无

# 请求参数

参数名 中文名称 必须 类型 描述
app_id 应用ID 是 String 目标应用ID
app_org_id 应用机构ID 是 String 目标应用机构ID

# 返回示例

成功示例：
HTTP/1.1 201 Created
Content-Type: application/json
{
    "org_id": "20220414151855146-A153-62C1A994C",
    "parent_id": null,
    "name": "虚拟机构2",
    "org_code": "xnjg",
    "disabled": false,
    "extension": {
        "uid": "123"
    }
}


错误示例：
HTTP/1.1 400 Bad Request
{
    "error_code": " APP.ORG.0024",
    "error_msg": "应用机构不存在	"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

# 返回参数

参数名 中文名称 类型 描述
org_id 应用机构ID String
org_code 应用机构code String
name 应用机构名称 String
parent_id 父节点ID String
disabled 是否已禁用 Boolean
extension 扩展属性 Map

# 错误码

状态码 错误码 错误信息 处理措施
400 APP.ORG.0024 应用机构不存在 请检查应用机构是否已被删除
The application organization does not exist

获取应用机构列表