REST API 参考
所有 API 端点以 /api/ 为前缀，需要通过会话 cookie 进行身份验证。所有请求和响应使用 Content-Type: application/json。
对话
| 端点 | 方法 | 描述 |
|---|---|---|
/api/conversations | GET | 列出对话（过滤器：status、channel_type、tag、search、page） |
/api/conversations/{id} | GET | 获取对话（重置 unread_count） |
/api/conversations | POST | 创建对话 |
/api/conversations/{id}/status | POST | 更新状态 |
/api/conversations/{id}/tags | POST | 添加标签 |
/api/conversations/{id}/tags/{tag} | DELETE | 移除标签 |
/api/conversations/{id}/assign | POST | 分配客服 |
消息
| 端点 | 方法 | 描述 |
|---|---|---|
/api/conversations/{id}/messages | GET | 列出消息 |
/api/conversations/{id}/messages | POST | 发送消息 |
AI 建议
| 端点 | 方法 | 描述 |
|---|---|---|
/api/ai-suggest?conversation_id={id} | GET | 获取 AI 回复建议 |
联系人
| 端点 | 方法 | 描述 |
|---|---|---|
/api/contacts | GET | 列出联系人 |
/api/contacts/{id} | GET | 获取联系人 |
/api/contacts | POST | 创建联系人 |
/api/contacts/{id} | PATCH | 更新联系人 |
/api/contacts/{id} | DELETE | 删除联系人（管理员） |
渠道（仅管理员）
| 端点 | 方法 | 描述 |
|---|---|---|
/api/channels | GET | 列出渠道 |
/api/channels | POST | 创建渠道 |
/api/channels/{id} | PATCH | 更新渠道 |
/api/channels/{id} | DELETE | 删除渠道 |
自动化（仅管理员）
| 端点 | 方法 | 描述 |
|---|---|---|
/api/automations | GET | 列出自动化 |
/api/automations | POST | 创建自动化 |
/api/automations/{id}/toggle | POST | 切换启用/禁用 |
/api/automations/{id} | DELETE | 删除自动化 |
分析
| 端点 | 方法 | 描述 |
|---|---|---|
/api/analytics?days=30 | GET | 获取分析数据 |
客服（仅管理员）
| 端点 | 方法 | 描述 |
|---|---|---|
/api/agents | GET | 列出客服 |
/api/agents | POST | 创建客服 |
/api/agents/{id}/role | POST | 更新角色 |
/api/agents/{id} | DELETE | 删除客服 |
设置
| 端点 | 方法 | 描述 |
|---|---|---|
/api/settings/workspace | GET | 获取工作区设置 |
/api/settings/workspace | POST | 更新工作区（管理员） |
/api/settings/password | POST | 修改密码 |
错误格式
{"error": "Human-readable error message"}
| 代码 | 含义 |
|---|---|
200 | 成功 |
201 | 已创建 |
400 | 错误请求 |
401 | 未认证 |
403 | 禁止访问 |
404 | 未找到 |
409 | 冲突 |
500 | 内部错误 |