Fecify-正常用户-列表

接口信息

• 接口地址: {your-site-url}/api/skill/account/list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
• 请求方式: GET
• Content-Type: application/json
• 说明: 获取审核通过的用户列表，或者直接创建的正常用户列表（该列表包含已激活和已禁用的用户），支持分页和多种条件搜索。

认证

请求头中需要携带 skill-access-token：

请求参数

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/account/list?pageNum=1&pageSize=10&loading=true&nickname=zhao&username=186618328666&created_at_begin=2021-07-01+00:00:00&created_at_end=2026-08-31+00:00:00&last_login_at_begin=2020-07-01+00:00:00&last_login_at_end=2026-08-31+00:00:00&status=1&type=2' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 141,
                "username": "186618328666",
                "nickname": "zhao",
                "status": 1,
                "created_at": "2026-04-28 19:27:23",
                "updated_at": "2026-04-28 19:27:23",
                "avatar_img": "",
                "type": 2,
                "last_login_at": 0,
                "shopmanagers": [
                    {
                        "id": 346,
                        "shop_id": 348,
                        "manager_id": 141,
                        "role_id": 0,
                        "user_type": 2
                    }
                ],
                "shops": [
                    {
                        "id": 348,
                        "name": "shop name",
                        "type": 10
                    }
                ]
            }
        ],
        "total": 30,
        "pageSize": 20,
        "totalPage": 2
    },
    "message": "success"
}

返回字段说明

data 子字段

list 子项

shops 子项

shopmanagers 子项

注意事项

1. loading=true 参数用于加载状态标识，不影响返回结果。
2. nickname 和 username 支持 LIKE 模糊搜索。
3. avatar_img 为相对路径，完整图片 URL = base_image_url + avatar_img。
4. 同一个用户可以关联多个店铺（一对多），shops 数组列出了该用户作为主账号的所有店铺。