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

创建组织

功能介绍

创建组织。

接口约束

无

URI

POST /api/v2/tenant/organizations

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

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

Authorization

是

String

认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。
表2 请求Body参数

参数

是否必选

参数类型

描述

code

是

String

组织编码，可输入中英文、数字、下划线和中划线。

最大长度：64

name

是

String

组织名称，所在层级下唯一，可输入中英文、数字、空格、中划线、下划线和&。

最大长度：100

parent_id

否

String

父组织id。创建父组织，不需要传递；创建子组织，需要传递。

category

否

String

组织类型。

缺省值：department：部门

枚举值：

  • department：部门
  • company：公司
  • unit：科
  • group：组

响应参数

状态码： 201

表3 响应Body参数

参数

参数类型

描述

org_id

String

组织ID。

状态码： 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

创建组织，组织名子部门，组织编码1000001，父组织编码20210623103509267-6ABA-201FFC...，组织类型部门。

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

Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...
{
  	"code": "1000001",
	"name": "子部门",
	"parent_id": "20210623103509267-6ABA-201FFC...",
        "category": "department"
}

响应示例

状态码： 201

创建成功。

{
  "org_id" : "20210623103509267-6ABA-201FFC..."
}

状态码

状态码

描述

201

创建成功。

400

参数无效。

错误码

请参见错误码。

父主题： 组织管理

相关文档