管理接口

后台管理相关接口，需要管理员权限。

仪表盘

GET /api/admin/dashboard
Authorization: Bearer {token}

响应

{
    "code": 0,
    "data": {
        "users": {"total": 1000, "today": 10},
        "photos": {"total": 5000, "today": 50},
        "storage": {"used": "10GB", "total": "100GB"},
        "trends": {...}
    }
}

用户管理

获取用户列表

GET /api/admin/users?page=1&limit=20&status=1

启用/禁用用户

PUT /api/admin/users/{id}/status
{
    "status": 1
}

删除用户

DELETE /api/admin/users/{id}

分配角色

PUT /api/admin/users/{id}/role
{
    "role_id": 2
}

图片审核

获取待审核图片

GET /api/admin/photos?status=pending

审核图片

PUT /api/admin/photos/{id}/audit
{
    "status": "approved",
    "reason": ""
}

批量审核

POST /api/admin/photos/batch-audit
{
    "ids": [1, 2, 3],
    "status": "approved"
}

删除图片

DELETE /api/admin/photos/{id}

批量删除

POST /api/admin/photos/batch-delete
{
    "ids": [1, 2, 3]
}

评论管理

获取评论列表

GET /api/admin/comments?page=1&status=pending

审核评论

PUT /api/admin/comments/{id}/audit
{
    "status": "approved"
}

批量删除评论

POST /api/admin/comments/batch-delete
{
    "ids": [1, 2, 3]
}

系统设置

获取所有配置

GET /api/admin/settings

响应

{
    "code": 200,
    "data": {
        "settings": {
            "system": {
                "name": "系统设置",
                "settings": [
                    {
                        "key": "site_name",
                        "value": "逍遥图库系统",
                        "type": "string",
                        "description": "站点名称"
                    }
                ]
            },
            "upload": { ... },
            "security": { ... },
            "performance": { ... },
            "feature": { ... }
        },
        "groups": {
            "system": "系统设置",
            "upload": "上传设置",
            "security": "安全设置",
            "performance": "性能设置",
            "feature": "功能开关"
        }
    }
}

获取分组配置

GET /api/admin/settings/group/:group

路径参数

参数	类型	说明
group	string	分组名称: system/upload/security/performance/feature

响应

{
    "code": 200,
    "data": {
        "group": "system",
        "name": "系统设置",
        "settings": [
            {
                "key": "site_name",
                "value": "逍遥图库系统",
                "type": "string",
                "description": "站点名称",
                "is_sensitive": false
            }
        ]
    }
}

更新配置

POST /api/admin/settings
Content-Type: application/json

{
    "settings": {
        "site_name": "我的图库",
        "upload_max_size": 20,
        "rate_limit_enabled": true
    }
}

响应

{
    "code": 200,
    "msg": "配置更新成功",
    "data": {
        "success": 3,
        "failed": 0,
        "errors": []
    }
}

清除配置缓存

DELETE /api/admin/settings/cache

响应

{
    "code": 200,
    "msg": "缓存清除成功"
}

上传系统图片

POST /api/upload/system
Content-Type: multipart/form-data

file: [图片文件]

支持格式

jpg, jpeg, png, gif, webp, svg, ico

大小限制

最大 2MB

响应

{
    "code": 200,
    "msg": "上传成功",
    "data": {
        "url": "/static/images/system/system_20250128120000_abc123.png",
        "filename": "system_20250128120000_abc123.png"
    }
}

配置项说明

系统设置 (system)

配置项	类型	说明
site_name	string	站点名称
site_version	string	系统版本
site_description	string	站点描述(SEO)
site_keywords	string	站点关键词(SEO)
site_author	string	站点作者
og_image	image	OG默认分享图片
site_logo	image	站点Logo图片

上传设置 (upload)

配置项	类型	说明
upload_max_size	number	单文件最大大小(MB)
upload_allowed_extensions	string	允许的文件扩展名
upload_max_width	number	图片最大宽度(px)
upload_max_height	number	图片最大高度(px)
thumbnail_width	number	缩略图宽度(px)
thumbnail_height	number	缩略图高度(px)
thumbnail_quality	number	缩略图质量(1-100)

安全设置 (security)

配置项	类型	说明
rate_limit_enabled	boolean	启用访问频率限制
rate_limit_default_max	number	默认每分钟最大请求数
csrf_enabled	boolean	启用CSRF防护
xss_filter_enabled	boolean	启用XSS过滤
cookie_secure	boolean	Cookie仅HTTPS传输
cookie_httponly	boolean	Cookie禁止JS访问
session_lifetime	number	Session有效期(秒)

性能设置 (performance)

配置项	类型	说明
apm_enabled	boolean	启用性能监控
apm_slow_threshold	number	慢请求阈值(ms)
cache_enabled	boolean	启用缓存
cache_ttl	number	默认缓存时间(秒)

功能开关 (feature)

配置项	类型	说明
enable_register	boolean	允许用户注册
enable_comment	boolean	允许评论功能
enable_review	boolean	启用内容审核
enable_watermark	boolean	启用自动水印