组织账号管理

组织账号列表: /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 位,包含字母和数字)