refactor(chat): remove failures section from API documentation

This commit is contained in:
2026-07-20 14:03:40 +08:00
parent 4d1c85727a
commit bfe48439b3
@@ -153,35 +153,6 @@ Authorization: Bearer <TOKEN>
费用、锁消息数量、成功解锁数量及 `messageIds` 都只计算当前角色。钱包余额仍是账号全局余额。 费用、锁消息数量、成功解锁数量及 `messageIds` 都只计算当前角色。钱包余额仍是账号全局余额。
## 9. Guest History Sync
```http
POST <API_BASE_URL>/api/chat/sync
Content-Type: application/json
Authorization: Bearer <LOGIN_TOKEN>
```
```json
{
"characterId": "maya-tan",
"messages": [
{"role": "user", "content": "Hello", "timestamp": "2026-07-17T09:00:00Z"},
{"role": "assistant", "content": "Hi", "timestamp": "2026-07-17T09:00:01Z"}
]
}
```
每次同步只能包含一个角色。本地若保存了多个角色,前端按角色分组分别调用。
若页面使用用户聊天统计,也必须带角色:
```http
GET <API_BASE_URL>/api/user/stats?characterId=maya-tan
```
其中 `totalMessages`、近期记忆、亲密度、情绪和关系状态都按角色返回。
响应会明确带上 `characterId``relationshipStage``currentMood`,前端不要把这些状态写回其他角色的本地缓存。
## 12. Tip Attribution ## 12. Tip Attribution
只有 Tip 订单使用角色归属: 只有 Tip 订单使用角色归属:
@@ -196,14 +167,3 @@ GET <API_BASE_URL>/api/user/stats?characterId=maya-tan
``` ```
Tip 订单必须携带 `recipientCharacterId`。VIP 和积分充值会忽略该字段。 Tip 订单必须携带 `recipientCharacterId`。VIP 和积分充值会忽略该字段。
## 13. Failures
| HTTP | `detail.errorCode` | Meaning | Frontend action |
| ---: | --- | --- | --- |
| 403 | `CHARACTER_DISABLED` | 角色或对应能力未开放 | 禁用输入并刷新角色目录 |
| 404 | `CHARACTER_NOT_FOUND` | 角色 ID 不存在 | 清理本地旧角色 ID,回角色列表 |
| 409 | `CHARACTER_MISMATCH` | 消息或双参数属于不同角色 | 不重试、不扣费,刷新当前角色历史 |
| 503 | `CHARACTER_STATE_UNAVAILABLE` | 角色会话状态暂不可用 | 保留输入并稍后重试 |
新前端的角色业务请求必须显式携带角色 ID。应用入口未指定角色时选择 Elio;显式错误、停用或不匹配的角色不会回退 Elio。