🛠️ 巧思工具箱 API 文档

认证会员工具知识问答天聚代理管理

📌 通用说明： 所有接口返回 JSON，格式为 { code: 200, msg: "success", data: {...} }。除登录外的接口需要在 Header 中携带 Authorization: Bearer {token}。

🔐 认证接口

POST/api/v1/auth/login

微信登录,使用 code 换取 openid 并签发 JWT。

请求参数:

codestring必填微信授权 code,由后端调用微信 code2Session 换取真实用户身份

nicknamestring可选用户昵称

avatarstring可选头像 URL

返回: token, user, member, beans, signed

👤 会员接口

GET/api/v1/member/info

获取当前登录用户信息。

返回: user, member(包含 level), beans, signed

POST/api/v1/member/signin

每日签到,返回奖励天豆数(连签+2)。

GET/api/v1/member/levels

获取所有会员等级。

GET/api/v1/member/beans

获取天豆变动记录。支持 page/size 分页。

GET/api/v1/member/favorites

获取收藏列表。

POST/api/v1/member/favorite

添加收藏。Body: { content_id, content_type, content_data }

DELETE/api/v1/member/favorite

取消收藏。Query: content_id, content_type

GET/api/v1/member/calls

获取调用日志。

PUT/api/v1/member/profile

更新用户资料。Body: { nickname, phone }

🔧 工具接口

GET/api/v1/tools

获取工具列表(可按 category 或 page 过滤)。返回: { all: [], grouped: {} }

GET/api/v1/tools/categories

获取分类汇总。

📚 知识问答

GET/api/v1/knowledge/quiz

获取答题题目。Query: category (poem_fill/idiom_fill/panduant/baike/wenda/cityriddle), limit (默认10)

POST/api/v1/knowledge/check

检查答题答案。Body: { type, question, answer, user_answer }

GET/api/v1/knowledge/literature

文学经典查询。Query: type (tangshi/songci/shijing/chengyu/riddle), keyword, page, size

GET/api/v1/knowledge/sayings

趣味语录。Query: category, limit (1=随机一条)

POST/api/v1/knowledge/acrostic

生成藏头诗。Body: { keyword, type (五言/七言) }

🌐 天聚代理

GET/api/v1/proxy/list

获取所有支持的代理接口列表。

GET/api/v1/proxy/{apiname}

通用代理接口,转发到天聚数行。Query 参数透传。

示例: GET /api/v1/proxy/tianqi?city=上海&type=1

POST/api/v1/proxy/{apiname}

POST 代理(用于图片识别等)。Body: 表单参数

⚙️ 管理接口

🔒 鉴权： 需要在 Header 添加 X-Admin-Token: {jwt.secret}

POST/api/v1/admin/sync

同步天聚数据到本地数据库(诗词/谜语/语录等)。

返回: { poem_fill: 数量, idiom_fill: 数量, tang_poem: 数量, ... }

GET/api/v1/admin/stats

数据库统计,返回各表记录数。

POST/api/v1/admin/tools

创建新工具(动态扩展)。

PUT/api/v1/admin/tools/:id

更新工具配置。

DELETE/api/v1/admin/tools/:id

禁用工具(软删除)。

❓ 错误码