huihuiSquare/docs/production-interface-inventory.md

生产环境接口清单

更新时间：2026-06-23

本文档整理的是本项目当前代码里会主动调用的外部生产环境接口，以及当前运行环境通过系统配置接口读到的真实生产地址。

当前生产配置

• 认证服务基址：https://99hui.com/api/usercenter
• 新闻业务基址：https://99hui.com/api/huihuibusiness
• 文件上传基址：https://99hui.com/api/filecenter 说明：代码通过把 huihuibusiness 替换成 filecenter 推导得到。
• 当前默认 AI 模型：
  • 模型名：阿里千问大模型
  • 提供方：qianwen
  • API Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
  • 模型版本：qwen-plus

认证服务

基址：https://99hui.com/api/usercenter

POST /open/login/token

• 用途：虚拟用户账号密码登录，换取 access_token
• 代码位置：
  • news_service.py
  • system.py

PATCH /v2/users/current

• 用途：同步修改目标平台用户资料
• 涉及字段：昵称、真实姓名、性别、头像、简介、邮箱
• 代码位置：
  • news_service.py

新闻业务服务

基址：https://99hui.com/api/huihuibusiness

GET /app/user/info

• 用途：登录成功后探测用户所属组织 orgId
• 代码位置：
  • news_service.py

GET /open/user/info

• 用途：登录成功后探测用户所属组织 orgId
• 代码位置：
  • news_service.py

GET /user/info

• 用途：登录成功后探测用户所属组织 orgId
• 代码位置：
  • news_service.py

GET /news/list

• 用途：会话有效性校验
• 代码位置：
  • news_service.py

GET /business/square/list

• 用途：
  • 统计今日文章数量
  • 拉取今日广场文章
  • 拉取历史广场文章
• 代码位置：
  • news_service.py
  • news_service.py
  • news_service.py

GET /news/{article_id}

• 用途：校验文章是否存在、正文是否足够长
• 代码位置：
  • news_service.py

PATCH /news/read/{news_id}

• 用途：模拟用户阅读新闻
• 代码位置：
  • news_service.py

POST /message/comment

• 用途：发表评论
• 代码位置：
  • news_service.py

GET /message/comment

• 用途：获取评论列表，为回复链路提供上下文
• 代码位置：
  • news_service.py

POST /message/comment/reply

• 用途：回复评论
• 代码位置：
  • news_service.py

POST /message/praise

• 用途：
  • 点赞
  • 收藏 说明：当前收藏复用了点赞接口
• 代码位置：
  • news_service.py
  • news_service.py

GET /news/share/wechat/{news_id}

• 用途：转发前的微信分享预热调用
• 代码位置：
  • news_service.py

POST /points/forward/news/{org_id}

• 用途：真正执行转发积分动作
• 代码位置：
  • news_service.py

DELETE /message/praise/cancel

• 用途：取消点赞 / 取消收藏
• 代码位置：
  • news_service.py

DELETE /message/comment/{news_id}/{comment_id}

• 用途：删除评论
• 代码位置：
  • news_service.py

文件服务

基址：https://99hui.com/api/filecenter

POST /fileUpload

• 用途：上传用户头像到平台文件中心
• 代码位置：
  • news_service.py

AI 模型服务

当前默认基址：https://dashscope.aliyuncs.com/compatible-mode/v1

POST /chat/completions

• 用途：
  • 生成人格
  • 生成评论
  • 生成回复
  • 测试模型连通性
• 代码位置：
  • ai_service.py
  • ai_service.py

说明

• resource.99hui.com 当前主要出现在头像上传成功后的返回 URL 中，属于资源访问域名，不是本项目后端主动调用的 API。
• AI 服务基址不是写死生产地址，而是读数据库里的模型配置；如果后台切换默认模型，这一节需要随之更新。
• 当前系统配置里 platform_org_id 为空，这和“部分用户点立即互动时取不到文章列表”现象高度相关，建议后续继续排查组织信息自动发现链路。