获取用户列表

已测完

GET

/v1/users

获取系统用户列表，需要管理员权限

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

返回响应

🟢200成功

application/json

获取用户列表成功

Body

🟠403禁止访问

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://127.0.0.1:3000/api/v1/users?page&size&role&status&search' \
--header 'Authorization: Bearer <token>'

响应示例

200 - 示例 1

{
    "code": 0,
    "message": "string",
    "data": {
        "items": [
            {
                "id": 0,
                "username": "string",
                "role": "user",
                "email": "user@example.com",
                "status": "active",
                "profile": {
                    "profile_name": "string",
                    "avatar_url": "string"
                },
                "created_at": "2019-08-24T14:15:22Z",
                "last_login": "2019-08-24T14:15:22Z"
            }
        ],
        "pagination": {
            "page": 1,
            "size": 1,
            "total": 0,
            "pages": 0
        }
    },
    "timestamp": "2019-08-24T14:15:22Z"
}

修改于 2025-07-10 14:04:43

获取用户

创建用户