refactor(chat): remove failures section from API documentation
This commit is contained in:
@@ -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。
|
|
||||||
|
|||||||
Reference in New Issue
Block a user