调动部门成员
查看文档来源信息
- 来源目录:
addons/sys_base/docs - 来源文件:
接口文档/41-调动部门成员.md
详细说明
用于将用户从原部门调动到目标部门;调动成功后,会按目标部门编码修正用户编号。
接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | PUT |
| 请求路径 | /sys_base/platform/organization/transferOrgUser |
| 来源文件 | 接口文档/41-调动部门成员.md |
请求头
| 请求头 | 示例值 | 说明 |
|---|---|---|
Content-Type | application/json | 请求体格式。 |
x-token | <登录令牌> | 登录令牌。 |
app-id | mid-admin | 当前应用 ID。 |
addons-type | sys_base | 当前模块标识。 |
入参
| 参数名 | 类型 | 是否必填 | 示例值 | 参数说明 |
|---|---|---|---|---|
organizationID | number | 是 | 2001 | 原部门 ID |
toOrganizationID | number | 是 | 2002 | 目标部门 ID |
sysUserIDS | array | 是 | [1001] | 用户 ID 列表 |
参数说明
organizationID:原部门 ID。toOrganizationID:目标部门 ID。sysUserIDS:用户 ID 列表。- 调动后,如果用户
publicId为空、格式不合法或不匹配目标部门编码,后端会按目标部门orgFlag + 4 位数字重新生成。 - 如果目标部门编码不符合规则,接口会拒绝调动,避免调动成功但用户编号无法修正。
请求示例
json
{
"organizationID": 2001,
"toOrganizationID": 2002,
"sysUserIDS": [
1001
]
}响应输出
json
{
"code": 1000,
"msg": "操作成功",
"data": {
"success": true,
"id": 1
}
}字段说明
| 字段名 | 类型 | 示例值 | 字段说明 |
|---|---|---|---|
code | number | 1000 | 业务状态码 |
msg | string | 操作成功 | 返回消息 |
data.success | boolean | true | 操作结果 |
data.id | number | 1 | 受影响记录 ID |
curl 示例
bash
curl --location --request PUT 'http://127.0.0.1:8100/sys_base/platform/organization/transferOrgUser' \
--header 'Content-Type: application/json' \
--header 'x-token: <登录令牌>' \
--header 'app-id: mid-admin' \
--header 'addons-type: sys_base' \
--data-raw '{
"organizationID": 2001,
"toOrganizationID": 2002,
"sysUserIDS": [
1001
]
}'