⚙️ System 系统配置与状态
系统级配置查询、用户体验/试用模式管理,以及用户资源使用量统计。
接口列表
GET/api/system/public-config
✅ 无需认证 · 公开接口
说明:获取系统的公开配置信息,包括登录页公告、版本信息等。
响应:
{
"config": {
"announcement": "欢迎使用...", // 登录页公告(可选)
"version": "1.0.0", // 系统版本号
"min_app_version": "1.0.0" // 最低支持的 App 版本(可选)
}
}
用户体验管理
开启或关闭当前用户的试用模式。试用模式下用户可无限制使用公共 AI 功能。
GET/api/system/user-status
✅ 需要认证(Bearer Token)
说明:查询当前用户在系统层级的特殊状态标记。
响应:
{
"is_public_ai_enabled": true // 是否启用公共 AI
}
POST/api/system/enable-trial
✅ 需要认证(Bearer Token)
说明:开启当前用户的试用/体验模式,通常放宽公共 AI 使用限制。
请求体:无
响应:{"success": true, "message": "试用已开启"}
POST/api/system/disable-trial
✅ 需要认证(Bearer Token)
说明:关闭当前用户的试用/体验模式,恢复正常用户权限。
请求体:无
响应:{"success": true, "message": "试用已关闭"}
资源使用量查询
GET/api/system/usage
✅ 需要认证(Bearer Token)
说明:获取当前用户在系统层级的资源使用情况,包括每日 Token 消耗配额等。
响应:
{
"daily_tokens_used": 12345, // 今日已用 Token
"daily_tokens_limit": 50000, // 每日 Token 上限
"subscription_plan": "free" // 当前订阅计划
}