部门

管理部门的组织单位创建、修改及层级结构维护等

---

全文检索部门列表

GET

/api/v1/dept/search

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

id

部门ID。

类型integer

格式"int64"

code

部门代码。

类型string

name

部门名称。

类型string

pid

父级部门ID。

类型integer

格式"int64"

level

部门级别。

类型integer

格式"int32"

tagId

部门关联标签ID。

类型integer

格式"int64"

createdBy

部门创建用户ID。

类型integer

格式"int64"

createdDate

部门创建日期。

类型string

格式"date-time"

pageNo

页面数据大小，默认为1，最大值为100000

类型integer

格式"int32"

最大值100000

最小值1

pageSize

页面数据大小，默认为10，最大值为2000

类型integer

格式"int32"

最大值2000

最小值1

orderBy

排序字段

类型string

orderSort

排序方法

类型string

有效值

"ASC""DESC"

filters[0].key

筛选字段名称

类型string

filters[0].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[0].value

筛选值

类型object

filters[1].key

筛选字段名称

类型string

filters[1].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[1].value

筛选值

类型object

filters[2].key

筛选字段名称

类型string

filters[2].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[2].value

筛选值

类型object

infoScope

查询信息范围

类型string

有效值

"BASIC""DETAIL"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/dept/search

试验场

授权

UserHttpBearer

变量

键

值

id

code

name

pid

level

tagId

createdBy

createdDate

pageNo

pageSize

orderBy

orderSort

filters[0].key

filters[0].op

filters[0].value

filters[1].key

filters[1].op

filters[1].value

filters[2].key

filters[2].op

filters[2].value

infoScope

示例

cURL

JavaScript

PHP

Python

---

查询部门列表

GET

/api/v1/dept

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

id

部门ID。

类型integer

格式"int64"

code

部门代码。

类型string

name

部门名称。

类型string

pid

父级部门ID。

类型integer

格式"int64"

level

部门级别。

类型integer

格式"int32"

tagId

部门关联标签ID。

类型integer

格式"int64"

createdBy

部门创建用户ID。

类型integer

格式"int64"

createdDate

部门创建日期。

类型string

格式"date-time"

pageNo

页面数据大小，默认为1，最大值为100000

类型integer

格式"int32"

最大值100000

最小值1

pageSize

页面数据大小，默认为10，最大值为2000

类型integer

格式"int32"

最大值2000

最小值1

orderBy

排序字段

类型string

orderSort

排序方法

类型string

有效值

"ASC""DESC"

filters[0].key

筛选字段名称

类型string

filters[0].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[0].value

筛选值

类型object

filters[1].key

筛选字段名称

类型string

filters[1].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[1].value

筛选值

类型object

filters[2].key

筛选字段名称

类型string

filters[2].op

筛选条件（等于、不等于、大于等）

类型string

有效值

"GREATER_THAN""LESS_THAN""GREATER_THAN_EQUAL""LESS_THAN_EQUAL""EQUAL""NOT_EQUAL""MATCH""MATCH_END""NOT_MATCH""NOT_MATCH_END""IN""NOT_IN""IS_NULL""IS_NOT_NULL"

filters[2].value

筛选值

类型object

infoScope

查询信息范围

类型string

有效值

"BASIC""DETAIL"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/dept

试验场

授权

UserHttpBearer

变量

键

值

id

code

name

pid

level

tagId

createdBy

createdDate

pageNo

pageSize

orderBy

orderSort

filters[0].key

filters[0].op

filters[0].value

filters[1].key

filters[1].op

filters[1].value

filters[2].key

filters[2].op

filters[2].value

infoScope

示例

cURL

JavaScript

PHP

Python

---

替换部门

PUT

/api/v1/dept

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

请求体

application/json

[

]

响应

成功

Content-Type

*/*

"string"

PUT

/api/v1/dept

试验场

授权

UserHttpBearer

主体

示例

cURL

JavaScript

PHP

Python

---

添加部门

POST

/api/v1/dept

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

请求体

application/json

[

]

响应

成功

Content-Type

*/*

"string"

POST

/api/v1/dept

试验场

授权

UserHttpBearer

主体

示例

cURL

JavaScript

PHP

Python

---

删除部门

DELETE

/api/v1/dept

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

查询参数

ids*

部门ID

类型array

必填

最大项数200

最小项数0

唯一项true

响应

成功

Content-Type

*/*

"string"

DELETE

/api/v1/dept

试验场

授权

UserHttpBearer

变量

键

值

ids*

示例

cURL

JavaScript

PHP

Python

---

更新部门

PATCH

/api/v1/dept

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

请求体

application/json

[

]

响应

成功

Content-Type

*/*

"string"

PATCH

/api/v1/dept

试验场

授权

UserHttpBearer

主体

示例

cURL

JavaScript

PHP

Python

---

查询子部门及部门用户数量

GET

/api/v1/dept/{id}/count

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

部门ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/dept/{id}/count

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

查询部门树的导航位置

GET

/api/v1/dept/{id}/navigation

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

部门ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/dept/{id}/navigation

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---

查询部门详情

GET

/api/v1/dept/{id}

授权

UserHttpBearer

使用现有不透明令牌进行身份验证

类型HTTP (bearer)

参数

路径参数

id*

部门ID

类型integer

必填

格式"int64"

响应

成功

Content-Type

*/*

"string"

GET

/api/v1/dept/{id}

试验场

授权

UserHttpBearer

变量

键

值

id*

示例

cURL

JavaScript

PHP

Python

---