请登录后查看
SearchDepartmentByName
按名称查询所有的部门
企业管理员通过该接口按名称查询所有的部门。
名称 | 类型 | 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。 |
deptName | string | query | 是 | 部门名称。 长度: 1-128位。 |
操作成功。
名称 | 类型 | 描述 |
---|---|---|
[数组元素] | Array of QueryDeptResultDTO objects | 部门信息 |
名称 | 类型 | 描述 |
---|---|---|
deptCode | string | 部门编码,企业内唯一。 |
deptLevel | integer | 部门层级。 |
deptName | string | 部门名称。 |
deptNamePath | string | 部门名路径。 |
isLeafNode | boolean | 是否叶子节点。 |
parentDeptCode | string | 父部门编码。 |
deptCodePath | string | 部门编码路径。 |
note | string | 备注。 |
corpId | string | 企业ID。 |
inPermission | string | 其他用户对该部门下用户的访问权限。 |
outPermission | string | 该部门下用户访问权限控制。 |
designatedOutDeptCodes | Array of IdMarkDTO objects | 允许访问的部门列表。 |
sortLevel | integer | 部门排序号。 |
名称 | 类型 | 描述 |
---|---|---|
id | string | 唯一标识。 |
mark | string | id对应的回显描述,一般为名称等。 |
参数异常。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
权限受限。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
"GET https://{endpoint}/v1/usg/dcs/member/dept?deptName=综合管理部"
操作成功。
[
{
"deptCode": "deptcode123456",
"deptLevel": 2,
"deptName": "综合管理部",
"deptNamePath": "根部门#deptNamePath",
"isLeafNode": true,
"parentDeptCode": "1",
"deptCodePath": "1#deptcode123456",
"note": "负责公司XX, XX等业务",
"corpId": "34733",
"inPermission": "UNLIMITED",
"outPermission": "DESIGNATED_DEPARTMENT",
"sortLevel": 10000,
"designatedOutDeptCodes": [
{
"id": "1",
"mark": "根部门"
}
]
}
]
参数异常。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.000000003",
"error_msg": "请检查参数是否合法"
}
权限受限。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.000000004",
"error_msg": "Illegal request"
}