查询部门列表
基本信息
请求方式:POST
请求地址:/napi/enterprise/department/list
Body参数
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|
| msgId | 消息id | Y | String | 128 | 1000120150511190411000001 | 企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN |
| corpCode | 企业编码 | N | String | 50 | 1000 | 不传默认查询租户级数据 |
| pageIndex | 页码 | Y | Int | | 1 | |
| pageSize | 每页条数 | Y | Int | | 20 | 建议20,上限50 |
| duration | 最近更新时间范围 | N | Duration | | | 不填默认查询最近一天 |
Duration
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|
| endTime | 结束时间 | Y | String | | 20240606110101 | yyyyMMddHHmmss格式 |
| startTime | 开始时间 | Y | String | | 20240605110101 | yyyyMMddHHmmss格式 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|
| resultCode | 返回码 | Y | String | | 0 | 0表示成功,其他值为失败。 |
| description | 描述 | Y | String | | 操作成功 | 描述信息,出错时为错误信息即错误原因。 |
| data | 响应数据 | Y | DepartmentPage | | | |
DepartmentPage
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|
| pageIndex | 页码 | Y | Int | | 1 | |
| pageSize | 每页条数 | Y | Int | | 20 | |
| totalSize | 总数 | Y | Long | | 100 | |
| departmentList | 部门列表 | Y | List<Department> | | | |
Department
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|
| departmentNo | 部门编号 | Y | String | 50 | A1234 | |
| nameCn | 中文名称 | Y | String | 200 | 市场部 | |
| nameEn | 英文名称 | N | String | 200 | Marketing Dept. | |
| parentNo | 上级部门编号 | N | String | 50 | | |
| corpCode | 企业编码 | Y | String | 50 | | |
| leaderList | 主管列表 | N | List<DepartmentLeader> | | | |
DepartmentLeader
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|
| tenantUserId | 租户用户id | Y | String | 200 | 440285 | |
| name | 姓名 | Y | String | 100 | 张三 | |
样例
请求
{
"duration": {
"startTime": "20240613135700",
"endTime": "20240613174346"
},
"pageIndex": 1,
"pageSize": 20,
"msgId": "0008120240617143030100010",
"corpCode": "0008"
}
返回
{
"resultCode": "0",
"description": "操作成功",
"data": {
"pageIndex": 1,
"pageSize": 20,
"totalSize": 1,
"departmentList": [
{
"departmentNo": "A1234",
"nameCn": "市场部",
"nameEn": "Marketing Dept.",
"parentNo": "A123",
"corpCode": "0008",
"leaderList": [
{
"tenantUserId": "d00xxxxxx",
"name": "张三"
}
]
}
]
}
}
错误码
| 错误码 | 错误描述 |
|---|
| 840000050 | 重复请求 |
| 840001021 | 企业不存在 |