{"openapi":"3.1.0","info":{"title":"赛衡智能体 API","version":"1.0.0","description":"赛衡智能体平台核心 API。外部服务未配置的接口会返回 NOT_CONFIGURED，不返回假成功。"},"servers":[{"url":"/"}],"paths":{"/api/auth/register":{"post":{"summary":"注册（含 Turnstile 票据验证）","tags":["Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/auth/login":{"post":{"summary":"登录（含 Turnstile 票据验证）","tags":["Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/auth/refresh":{"post":{"summary":"刷新 Token","tags":["Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/auth/logout":{"post":{"summary":"登出","tags":["Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/auth/forgot-password":{"post":{"summary":"请求 10 分钟密码重置邮件（响应不泄露账号是否存在）","tags":["Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/auth/reset-password":{"post":{"summary":"使用一次性令牌重置密码并撤销旧会话","tags":["Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/admin/users/recovery":{"post":{"summary":"超级管理员签发一次性账号恢复凭证并强制改密","tags":["Admin","Auth"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/auth/redeem":{"post":{"summary":"兑换充值卡余额与模型档位","tags":["Auth","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/users/me":{"get":{"summary":"当前用户","tags":["User"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"更新资料和体验偏好","tags":["User"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/users/me/avatar":{"get":{"summary":"读取头像","tags":["User"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"上传并裁剪头像","tags":["User"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/users/me/export":{"get":{"summary":"导出个人数据","tags":["Compliance"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/users/me/delete":{"post":{"summary":"提交账号注销申请","tags":["Compliance"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/projects":{"get":{"summary":"项目列表","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"创建项目","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/projects/{id}":{"get":{"summary":"项目详情","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"更新项目","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"软删除项目","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/projects/{id}/files":{"get":{"summary":"文件列表","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"上传资料","tags":["Project"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/agents":{"get":{"summary":"Agent 列表","tags":["Agent"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/agents/{id}/execute":{"post":{"summary":"创建单 Agent 队列任务并立即返回执行 ID","tags":["Agent","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/agents/{id}/executions/{executionId}":{"get":{"summary":"轮询单 Agent 执行状态与结果","tags":["Agent"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/jobs":{"post":{"summary":"创建或复用完整交付后台任务","tags":["Agent"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"get":{"summary":"查询完整交付任务进度","tags":["Agent"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"取消完整交付任务并幂等退款","tags":["Agent"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/workflows/{id}/execute":{"post":{"summary":"执行工作流并汇总实际 Token 结算","tags":["Agent","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/model-tiers":{"get":{"summary":"模型档位与当前选择","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"更新用户模型档位","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/prompts":{"get":{"summary":"用户端提示词列表（只读）","tags":["Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/prompts/{id}":{"get":{"summary":"用户端提示词详情（只读）","tags":["Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/prompts/{id}/use":{"post":{"summary":"使用提示词并校验输出合同","tags":["Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/skills":{"get":{"summary":"用户端 Skill 列表与安装状态（只读）","tags":["Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/skills/{id}":{"get":{"summary":"用户端 Skill 详情（只读）","tags":["Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/skills/{id}/execute":{"post":{"summary":"执行 Skill","tags":["Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/admin/api/prompts":{"get":{"summary":"管理员提示词列表","tags":["Admin","Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"管理员创建提示词","tags":["Admin","Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/admin/api/prompts/{id}":{"get":{"summary":"管理员提示词详情","tags":["Admin","Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"管理员更新提示词","tags":["Admin","Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"管理员删除或停用提示词","tags":["Admin","Prompt"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/admin/api/skills":{"get":{"summary":"管理员 Skill 列表","tags":["Admin","Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"管理员创建 Skill","tags":["Admin","Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/admin/api/skills/{id}":{"get":{"summary":"管理员 Skill 详情","tags":["Admin","Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"管理员更新 Skill","tags":["Admin","Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"管理员删除或停用 Skill","tags":["Admin","Skill"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/knowledge":{"get":{"summary":"知识库列表","tags":["Knowledge"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"创建知识库","tags":["Knowledge"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tools/parse":{"post":{"summary":"文件解析","tags":["Tools"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tools/profile":{"post":{"summary":"数据画像","tags":["Tools"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tools/clean":{"post":{"summary":"数据清洗","tags":["Tools"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tools/charts":{"post":{"summary":"图表生成","tags":["Tools"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tools/upload":{"post":{"summary":"上传 24 小时过期的工具临时文件","tags":["Tools"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tools/temp-files/cleanup":{"post":{"summary":"管理员清理过期工具文件和未发布社区图片","tags":["Admin","Tools","Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/trends":{"get":{"summary":"官方竞赛趋势、快照和数据新鲜度","tags":["Trends"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/topic-trends":{"get":{"summary":"政府、行业与赛事平台命题趋势","tags":["Trends"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/admin/trends/crawl":{"get":{"summary":"管理员查看采集运行","tags":["Admin","Trends"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"触发官方来源采集","tags":["Admin","Trends"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/boards":{"get":{"summary":"交流区板块列表","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/{board}/posts":{"get":{"summary":"板块帖子分页","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"发布帖子","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/{board}/posts/{postId}":{"get":{"summary":"帖子详情","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"patch":{"summary":"编辑帖子或管理置顶/精华/锁定","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"软删除帖子","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/{board}/posts/{postId}/replies":{"get":{"summary":"回复与楼中楼分页","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"发布回复","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/replies/{replyId}":{"patch":{"summary":"编辑回复","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"软删除回复","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/replies/{replyId}/like":{"post":{"summary":"切换回复点赞","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/images":{"post":{"summary":"已关闭：交流区仅支持文字和表情","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/tieba/images/{imageId}":{"get":{"summary":"受控读取社区图片","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"删除本人未引用社区图片","tags":["Community"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/evaluation":{"get":{"summary":"评估列表","tags":["Evaluation"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"创建评估","tags":["Evaluation"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/publish/preview":{"get":{"summary":"只读预览待导出的项目交付物","tags":["Publish"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/publish/docx":{"post":{"summary":"导出 DOCX","tags":["Publish"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/publish/pptx":{"post":{"summary":"导出 PPTX","tags":["Publish"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/publish/pdf":{"post":{"summary":"导出中文 PDF 项目总结","tags":["Publish"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/billing/subscription":{"get":{"summary":"余额账户和用量","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"在线套餐已下线（410）","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/billing/coupons":{"get":{"summary":"用户额度券","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"兑换额度券","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/billing/referrals":{"get":{"summary":"历史邀请记录","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"邀请返利已下线（410）","tags":["Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/admin/billing-config":{"get":{"summary":"计费参数与模型档位","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"更新计费参数与模型档位","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"停用模型档位","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/admin/redemption-codes":{"get":{"summary":"兑换码列表","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"post":{"summary":"批量生成兑换码","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"put":{"summary":"更新兑换码","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}},"delete":{"summary":"删除或停用兑换码","tags":["Admin","Billing"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/operations/analytics":{"get":{"summary":"运营统计","tags":["Admin"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/health":{"get":{"summary":"健康检查","tags":["Ops"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}},"/api/system/status":{"get":{"summary":"功能状态和缺口矩阵","tags":["Ops"],"responses":{"200":{"description":"成功"},"400":{"description":"参数错误"},"401":{"description":"未登录"},"403":{"description":"无权限"},"501":{"description":"功能未配置或未实现"}}}}}}