部门列表查询
说明
该接口用于获取部门列表。
接口限制
1. 10次/秒;
接口地址
/api/openapi/org/department/search
请求类型
POST
请求参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| keyword | String(100) | 否 | 可以根据业务编码和部门名称模糊查询 |
| offset | int | 否 | 当前页首条数据在所有数据中的偏移量，默认值0。 例如：若pageSize=100，下一次offset=100，以此类推 |
| pageSize | int | 否 | 每页条数。默认50条，最大值100条。 |
参数样例
{
"offset": 0,
"pageSize": 10,
"keyword": "测试"
}
响应参数
参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| total | int | 记录总数 |
| offset | int | 当前页首条数据在所有数据中的偏移量，默认值0。例如：若pageSize=100，下一次offset=100，以此类推 |
| pageSize | int | 查询 指定 条数 |
| hasNextPage | boolean | 是否还有下一页 |
| list | List<Department> | 返回部门列表 |
Department 说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| name | String | 部门名称 |
| businessCode | String | 部门业务编码 |
| managerEmployeeIds | List<String> | 部门主管工号 |
| parentBizCode | String | 上级部门编码 |
| fullName | List<String> | 部门全路径 |
| fullNameEn | List<String> | 部门英文名全路径 |
| enabled | boolean | 是否启用 |
| controlProperties | List<String> | 部门控制属性 reimburse_dept_scene --报销单的承担部门场景下不可以被选 pre_consume_dept_scene --申请单申请部门场景下不可以被选share_dept_scene --分摊的承担部门场景下不可以被选 loan_dept_scene --借款单的承担部门场景下不可以被选 contract_dept_scene --合同的部门场景下不可以被选 repayment_dept_scene --还款单的责任人部门场景下不可以被选 |
| nameZh | String | 部门中文名 |
| nameEn | String | 部门英文名 |
| i18nName | I18nName.md | 部门多语言名称。key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的部门名称。仅返回系统已启用的语言，未启用的语言不返回。已启用但未维护的语言返回空字符串 |
参数样例
{
"code": "ACK",
"message": "",
"data": {
"total": 1,
"offset": 0,
"pageSize": 10,
"list": [
{
"name": "每刻测试",
"businessCode": "DI2001061HIX0IYQ",
"managerEmployeeIds": [
"MK001"
],
"parentBizCode": "DI1803221E22UHXF",
"fullName": [
"杭州每时每刻有限公司",
"每刻测试"
],
"fullNameEn": [],
"enabled": true,
"controlProperties": [
"reimburse_dept_scene"
],
"nameZh": "每刻科技",
"nameEn": "maycurCompany",
"i18nName": {
"zh": "组织名称",
"en": "Organization Name",
"ja": "組織名",
"zh-TW": "組織名稱",
"ko": "조직명",
"fr": "Nom de l'organisation",
"es": "Nombre de la organización",
"pt": "Nome da organização",
"vi": "Tên tổ chức",
"th": "ชื่อองค์กร",
"id": "Nama organisasi",
"ru": "Название организации",
"hu": "Szervezet neve",
"et": ""
}
},
{
"name": "产品研发部",
"businessCode": "DI1803221E22UHXG",
"managerEmployeeIds": null,
"parentBizCode": "DI1803221E22UHXF",
"enabled": true,
"fullName": [
"杭州每时每刻有限公司",
"产品研发部"
],
"controlProperties": [],
"i18nName": {
"zh": "组织名称",
"en": "Organization Name",
"ja": "組織名",
"zh-TW": "組織名稱",
"ko": "조직명",
"fr": "Nom de l'organisation",
"es": "Nombre de la organización",
"pt": "Nome da organização",
"vi": "Tên tổ chức",
"th": "ชื่อองค์กร",
"id": "Nama organisasi",
"ru": "Название организации",
"hu": "Szervezet neve",
"et": ""
}
}
],
"hasNextPage": false
},
"success": true
}
修改记录
2020-10-14 初始化
2020-11-06 接口查询逻辑修改
2020-11-10 添加controlProperties属性，非必须字段
2021-1-21 增加nameZh，nameEn 返回字段
2026-06-26 增加 i18nName 字段