refactor(chat): remove failures section from API documentation
This commit is contained in:
@@ -153,35 +153,6 @@ Authorization: Bearer <TOKEN>
|
||||
|
||||
费用、锁消息数量、成功解锁数量及 `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
|
||||
|
||||
只有 Tip 订单使用角色归属:
|
||||
@@ -196,14 +167,3 @@ GET <API_BASE_URL>/api/user/stats?characterId=maya-tan
|
||||
```
|
||||
|
||||
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。
|
||||
|
||||
Reference in New Issue
Block a user