组织账号管理
组织账号列表: /organizationAccounts GET
请求参数
| 参数名 | 示列值 | 类型 | 必须 | 说明 | 默认值 |
|---|---|---|---|---|---|
| page | 1 | number | 否 | 当前页数 | 1 |
| pageSize | 10 | number | 否 | 每页条数 | 10 |
| sort | -createdAt | string | 否 | 排序字段 | |
| organizationId | 1 | number | 否 | 组织 ID | |
| name | 张三 | string | 否 | 名称搜索 | |
| account | 13800138000 | string | 否 | 账号搜索 | |
| roleId | 1 | number | 否 | 角色 ID | |
| departmentIds | [1,2,3] | string | 否 | 部门 ID 列表 | |
| status | 1 | number | 否 | 状态搜索 |
返回参数
| 参数名 | 示列值 | 说明 |
|---|---|---|
| page | 1 | 当前页数 |
| pageSize | 10 | 每页条数 |
| limit | 10 | 同 pageSize |
| offset | 2 | 起始条数 |
| total | 100 | 符合条件的总数量 |
| items | [{ "id": 1, "name": "test"}] | 返回数据项 |
返回示例
HTTP/1.1 200 OK
{
"page": 1,
"pageSize": 10,
"limit": 10,
"offset": 0,
"total": 100,
"items": [
{
"id": 1,
"name": "张三",
"account": "13800138000",
"roleId": 1,
"role": {
"id": 1,
"name": "管理员"
},
"departmentIds": [1, 2],
"departments": [
{
"id": 1,
"name": "总经办"
}
],
"organizationId": 1,
"status": 1,
"createdAt": 1653448129,
"updatedAt": 1653448129
}
]
}
启用/禁用组织账号: /organizationAccounts/:id/status PUT
Token: authorization
请求参数
| 参数名 | 路径参数 | 类型 | 必须 | 说明 |
|---|---|---|---|---|
| id | 是 | number | 是 | 账号 ID |
Body 参数
| 参数名 | 示列值 | 类型 | 必须 | 说明 |
|---|---|---|---|---|
| status | 1 | number | 是 | 0 禁用 1 启用 |
返回示例
HTTP/1.1 200 OK
{
"id": 1,
"name": "张三",
"account": "13800138000",
"status": 1,
"updatedAt": 1711161600
}
重置组织账号密码: /organizationAccounts/:id/resetPassword PUT
Token: authorization
请求参数
| 参数名 | 路径参数 | 类型 | 必须 | 说明 |
|---|---|---|---|---|
| id | 是 | number | 是 | 账号 ID |
Body 参数
| 参数名 | 示列值 | 类型 | 必须 | 说明 |
|---|---|---|---|---|
| password | Abc12345 | string | 是 | 新密码,8-16 位,需符合密码强度规则 |
返回示例
HTTP/1.1 200 OK
{
"id": 1,
"name": "张三",
"account": "13800138000",
"updatedAt": 1711161600
}
说明:
- 所有接口需要登录认证,通过 authorization Token 鉴权
- 启用/禁用和重置密码操作会记录操作日志
- 密码需符合密码强度规则(8-16 位,包含字母和数字)