员工身份(EIAM)
新增组织
接口
# 权限
身份管理API是以应用维度授权的，在调用接口前需为不同的应用设置接口权限，详情请参考API权限。
| 权限代码 | 描述 |
|---|---|
| org_all | 组织管理接口的读写权限 |
| all | 全部接口读写权限 |
# 请求说明
POST https://{your_domain}/api/v2/tenant/organizations
# 请求头
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| Authorization | 授权 | 是 | String | 格式：Bearer {access_token} |
| Content-Type | 内容类型 | 是 | String | 固定值：application/json; charset=utf-8 |
# 请求示例
{
"code": "TestOrg2",
"name": "测试机构2",
"parent_id": "",
"category": "department",
"sequence": 5,
"extension": {
"uid": "123"
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
# 请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| code | 组织code | 是 | String | 组织code |
| name | 组织名称 | 是 | String | 组织名称 |
| parent_id | 父节点id | 否 | String | 父节点id |
| category | 组织类型 | 否 | String | 组织类型代码 |
| sequence | 显示顺序 | 否 | int | 显示顺序 |
| extension | 扩展属性 | 否 | Map | 扩展属性，扩展的属性需要在企业中定义 |
# 返回示例
成功示例：
HTTP/1.1 201 Created
Content-Type: application/json
{
"org_id": "20220412142914549-1E50-B49C521A4"
}
错误示例：
HTTP/1.1 400 Bad Request
{
"error_code": "ORG.0008",
"error_msg": "父级组织不存在"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 返回参数
| 参数名 | 中文名称 | 类型 | 描述 |
|---|---|---|---|
| org_id | 创建的组织id | String | 系统自动生成 |
# 错误码
| 状态码 | 错误码 | 错误信息 | 处理措施 |
|---|---|---|---|
| 400 | ORG.0008 | 父级组织不存在 | 请检查父组织是否存在 |
| The parent organization does not exist | |||
| 400 | ORG.0011 | 组织类型不能为空 | 请检查入参中的组织类型是否为空 |
| Organization type cannot be empty | |||
| 400 | ORG.0012 | 组织编码不能为空 | 请检查入参中的组织编码是否为空 |
| Organization code cannot be empty | |||
| 400 | ORG.0013 | 组织名称不能为空 | 请检查入参中的组织名称型是否为空 |
| Organization name cannot be empty | |||
| 400 | ORG.0015 | 组织编码已存在 | 当前组织编码已存在，请更换为其他不存在的值 |
| Organization code already exists | |||
| 400 | ORG.0016 | 组织名称已存在 | 当前组织名称已存在，请更换为其他不存在的值 |
| Organization name already exists | |||
| 400 | ORG.0017 | 组织编码不符合校验规则 | 请检查入参中的组织编码字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| Organization code does not meet verification rules | |||
| 400 | ORG.0018 | 组织名称不符合校验规则 | 请检查入参中的组织名称字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| Organization name does not meet verification rules | |||
| 400 | ORG.0028 | 组织层级不能超过{0}层 | 请检查组织的层级是否超过{0}层 |
| The organization level cannot exceed {0} level | |||
| 400 | ORG.0030 | 上级组织不能为空 | 请检查入参中的上级组织是否为空 |
| The parent organization cannot be empty | |||
| 400 | ORG.0032 | 显示顺序不能为空 | 请检查入参中的显示顺序是否为空 |
| Organization sequence number cannot be empty | |||
| 400 | ORG.0035 | 扩展属性[{0}]不能为空 | 请检查入参中的扩展属性[{0}]字段是否为空 |
| Extension attribute [{0}] cannot be empty | |||
| 400 | ORG.0039 | 扩展属性[{0}]已存在 | 当前扩展属性[{0}]的值已存在，请更换为其他不存在的值 |
| Extension attribute [{0}] already exists | |||
| 400 | ORG.0040 | 组织全名不符合校验规则 | 请检查入参中的组织全名字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| Organization full name does not meet verification rules | |||
| 400 | ORG.0041 | 组织类型不符合校验规则 | 请检查入参中的组织类型字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| Organization type does not meet verification rules | |||
| 400 | ORG.0042 | 上级组织不符合校验规则 | 请检查入参中的上级组织字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| The parent organization does not meet the verification rules | |||
| 400 | ORG.0044 | 显示顺序不符合校验规则 | 请检查入参中的显示顺序字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| The organization sequence number does not meet the verification rules | |||
| 400 | ORG.0047 | 扩展属性[{0}]不符合校验规则 | 请检查入参中的扩展属性[{0}]字段是否符合【企业中心-用户-组织属性定义】中的校验规则 |
| Extension property [{0}] does not meet verification rules |