请登录后查看
AddDepartment
添加部门
企业管理员通过该接口添加部门,最多支持10级部门,每级子部门最多支持100个,默认企业最大部门数量为10000个。
名称 | 类型 | IN | 必选 | 描述 |
---|---|---|---|---|
Accept-Language | string | header | 否 | 语言参数,默认为中文zh-CN,英文为en-US。 |
X-Request-Id | string | header | 否 | 请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。 |
X-Access-Token | string | header | 是 | Access Token。通过 执行App ID鉴权接口返回的accessToken。 |
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
deptCode | string | 否 | 部门编码,企业内唯一,若携带则以携带为准,不支持修改。 |
deptName | string | 是 | 部门名称。 |
parentDeptCode | string | 否 | 父部门编码,默认为根部门。 默认值:1。 |
note | string | 否 | 备注。 |
inPermission | string | 否 | 其他用户对该部门下用户的访问权限。
|
outPermission | string | 否 | 该部门下用户访问权限控制。
|
designatedOutDeptCodes | Array of strings | 否 | 允许访问的部门列表,仅outPermission为DESIGNATED_DEPARTMENT时有效,最多支持配置150个部门。 |
sortLevel | integer | 否 | 部门排序号,序号越小,部门排序越靠前。 |
操作成功。
名称 | 类型 | 描述 |
---|---|---|
value | string | 返回结果。 |
参数异常。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
权限受限。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
"POST https://{endpoint}/v1/usg/dcs/corp/dept"
{
"deptCode": "deptcode123456",
"deptName": "综合管理部",
"parentDeptCode": "1",
"note": "负责公司XX, XX等业务",
"inPermission": "UNLIMITED",
"outPermission": "DESIGNATED_DEPARTMENT",
"sortLevel": 10000,
"designatedOutDeptCodes": [
"i6A",
"KR7"
]
}
操作成功。
{
"value": "deptcode123456"
}
参数异常。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.201030000",
"error_msg": "部门不存在"
}
权限受限。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.000000004",
"error_msg": "Illegal request"
}