lixi f848476c16 docs(api): M3 契约冻结 v1.3.0——community/media 域合入 ...

按第二波定型表（iteration-3 报告 13/15/16/17）将 community/media 域草案
合入正典 openapi.yaml，1.2.0 → 1.3.0：

- 新增 13 路径 / 19 操作（媒体两步上传、帖子生命周期、公共 Feed、
  单层评论、点赞/收藏/关注最小接口），正典总量 31 路径 / 43 操作
- 新增 27 schemas / 4 参数 / 7 响应组件；错误码表补 9 码
  （40301/40403/40404/40405/40406/40905/42203/42204/42205）
- info 头新增「Community / Media 域约定」：Idempotency-Key 必带 +
  规范化 request_hash 比对（与 pets 域差异成文）、私有桶 + 时效性
  预签名 GET 读取语义、防枚举码族、互动面=帖子公开面
- 草案 10 处 TODO-FREEZE 全部回填删除；26 项草案→冻结修正照单全收
  （对照见 iteration-3/18 冻结报告，波末入档）
- index.md 端点清单同步；servers 增 :8084、tags 并入 6 个

api 侧字节级快照同步为硬依赖，由后续 api 侧工单执行。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-09-09 11:12:50 +08:00

140 KiB

Raw Blame History