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](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:149)
  - [system.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/api/endpoints/system.py:86)

### `PATCH /v2/users/current`

- 用途：同步修改目标平台用户资料
- 涉及字段：昵称、真实姓名、性别、头像、简介、邮箱
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:946)

## 新闻业务服务

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

### `GET /app/user/info`

- 用途：登录成功后探测用户所属组织 `orgId`
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:250)

### `GET /open/user/info`

- 用途：登录成功后探测用户所属组织 `orgId`
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:250)

### `GET /user/info`

- 用途：登录成功后探测用户所属组织 `orgId`
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:250)

### `GET /news/list`

- 用途：会话有效性校验
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:323)

### `GET /business/square/list`

- 用途：
  - 统计今日文章数量
  - 拉取今日广场文章
  - 拉取历史广场文章
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:350)
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:483)
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:620)

### `GET /news/{article_id}`

- 用途：校验文章是否存在、正文是否足够长
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:396)

### `PATCH /news/read/{news_id}`

- 用途：模拟用户阅读新闻
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:711)

### `POST /message/comment`

- 用途：发表评论
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:734)

### `GET /message/comment`

- 用途：获取评论列表，为回复链路提供上下文
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:759)

### `POST /message/comment/reply`

- 用途：回复评论
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:747)

### `POST /message/praise`

- 用途：
  - 点赞
  - 收藏
  说明：当前收藏复用了点赞接口
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:771)
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:784)

### `GET /news/share/wechat/{news_id}`

- 用途：转发前的微信分享预热调用
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:796)

### `POST /points/forward/news/{org_id}`

- 用途：真正执行转发积分动作
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:802)

### `DELETE /message/praise/cancel`

- 用途：取消点赞 / 取消收藏
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:830)

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

- 用途：删除评论
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:865)

## 文件服务

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

### `POST /fileUpload`

- 用途：上传用户头像到平台文件中心
- 代码位置：
  - [news_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/news_service.py:1002)

## AI 模型服务

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

### `POST /chat/completions`

- 用途：
  - 生成人格
  - 生成评论
  - 生成回复
  - 测试模型连通性
- 代码位置：
  - [ai_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/ai_service.py:70)
  - [ai_service.py](/Users/yqq/Works/AiProject/huihuiSquare/backend/app/services/ai_service.py:215)

## 说明

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