Skip to main content
所有 Client API 前缀为 /api,除认证接口外均需在 Header 中携带 JWT Token:

认证(Auth)

发送邮箱验证码

string
required
邮箱地址
string
required
用途:register | login | reset_password
响应:

邮箱 + 验证码注册

请求 Body: 响应: TokenResponseaccess_token + token_type

邮箱 + 密码注册

请求 Body: 响应: TokenResponse

邮箱 + 密码登录

请求 Body: 响应: TokenResponse

邮箱 + 验证码登录

请求 Body: 响应: TokenResponse

重置密码

请求 Body: 响应: ActionResponseok + message

小程序登录

请求 Body: 响应:

用户(User)

获取用户资料

响应:

获取用户身份列表

响应: 身份对象数组,每项包含 platformplatform_idcreated_at

提交反馈

请求 Body: 响应: FeedbackCreateResponseok + id

生成绑定码

请求 Body: 响应: BindCodeCreateResponseok + code + expires_in

消费绑定码

请求 Body: 响应:

对话(Chat)

获取聊天记录

查询参数: 响应: 消息对象数组(按时间正序):

发送消息

查询参数: 请求 Body: 非流式响应:
流式响应(SSE):
流式模式返回 text/event-stream,每个 SSE event 的 data 为 JSON,包含 chunk(增量文本)或 done(完成标记)。

WebSocket 对话

详见 WebSocket 协议文档

会话管理(Conversations)

获取会话列表

响应: ConversationResponse 数组:

获取当前会话

响应: 单个 ConversationResponse

创建会话

请求 Body: 响应: ConversationResponse

切换会话

响应: ConversationResponse

重命名会话

请求 Body: 响应: ConversationResponse

删除会话

响应:

账本(Ledger)

获取账本列表

查询参数: 响应: LedgerItemResponse 数组:

创建账本记录

请求 Body: 响应: LedgerItemResponse

更新账本记录

请求 Body: 响应: LedgerItemResponse

删除账本记录

响应: { "ok": true, "id": 123 }

账本统计

查询参数:

日历视图

查询参数: 响应:

日程(Schedule)

获取日程列表

查询参数: 响应: ScheduleItemResponse 数组:

创建日程

请求 Body: 响应: ScheduleItemResponse

更新日程

请求 Body: 响应: ScheduleItemResponse

删除日程

响应: { "ok": true, "id": 123 }

技能(Skills)

获取技能列表

响应: SkillItemResponse 数组:

获取技能详情

查询参数: 响应:SkillItemResponse 基础上增加 content_md(Markdown 内容)。

创建 / 更新草稿

请求 Body: 响应:

发布技能

响应: SkillItemResponse

禁用技能

响应: SkillItemResponse

MCP 工具

获取工具列表

响应: 工具对象数组:

抓取 URL 内容

请求 Body: 响应: { "content": "..." }

配置(Config)

获取小程序首页弹窗配置

响应: