lixi
2ceab6b296
CI / docs-build (push) Successful in 1m22s
以 AnalyticsController 实测行为为准补录埋点上报端点：批量 1-50、 202 逐条结果（accepted/duplicate/rejected + 4 种拒绝原因）、eventId 幂等、唯一允许匿名的写端点（带 Bearer 则完整校验 401/40101）、 400/40000 整批拒绝。info.version 1.0.0 -> 1.1.0（纯增量）； index.md 端点清单同步为 6 端点。python yaml 解析 + mkdocs build --strict 均通过。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
737 B
737 B
API 契约
正式契约见 openapi.yaml（OpenAPI 3），当前 6 个端点：
- 认证域（第一迭代冻结）：注册、登录、刷新、退出、当前用户 5 个端点，统一错误信封
{code, message, data}与错误码表（40000/40100/40101/40102/40900/40901/42300），以及会话轮换与登录锁定策略说明。 - 埋点域（M2 第一波补录）：
POST /api/v1/events批量上报产品事件——单批 1–50 条、202 逐条结果（accepted/duplicate/rejected）、eventId幂等去重、唯一允许匿名的写端点（携带 Bearer 则完整校验）。
约定：契约变更须先改本文件目录下的 OpenAPI，再改实现（契约先行）；错误码只增不改义。