文档首页/应用身份管理服务 OneAccess/API参考/API/管理类接口/应用机构管理/新增应用机构 - CreateAppOrg
更新时间：2025-11-03 GMT+08:00
查看PDF
分享

新增应用机构 - CreateAppOrg

功能介绍

新增应用机构。

接口约束

null

URI

POST /api/v2/tenant/applications/{application_id}/organizations

表1 路径参数

参数

是否必选

参数类型

描述

application_id

是

String

应用id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

该字段内容填为“application/json;charset=utf8”。

Authorization

是

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

org_code

是

String

应用机构编码，可输入中英文、数字、下划线和中划线。

name

是

String

应用机构名称，可输入中英文、数字、空格、中划线、下划线和&。

parent_id

否

String

创建应用根机构不需要传，创建应用子机构需要传父机构id。

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

org_id

String

应用机构id。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

  • 新增根机构，机构编码为10000，机构名称为总部。

    POST https://{domain_name}/api/v2/tenant/applications/{application_id}/organizations

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

{
  "org_code":"10000",
  "name":"总部",
  "parent_id": ""
}

  • 新增子机构，机构编码为10001，机构名称为开发组，父机构id为20210623103520050-C5AF-DD1A97...。

    POST https://{domain_name}/api/v2/tenant/applications/{application_id}/organizations

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

{
  "org_code":"10001",
  "name":"开发组",
  "parent_id":"20210623103520050-C5AF-DD1A97..."
}

响应示例

状态码：201

请求成功。

{
  "org_id" : "20210623103520050-C5AF-DD1A97..."
}

状态码

状态码

描述

201

请求成功。

400

参数无效。

错误码

请参见错误码。

父主题：应用机构管理

相关文档