开发者
开发者概览
如果你的产品里有 Agent，或者需要 Agent 能信得过的按用户状态，可以在 SaveSlot 上构建。开发者工具在工作台的「开发者」里。
两条路径
| 路径 | 什么时候用 | 怎么做 |
|---|---|---|
| MCP + Skill | 你的产品里有 Agent | 把它指向云端 MCP 服务器，并给它 SaveSlot 的 Skill。它读写的方式和 Claude、ChatGPT 一样。见 MCP 工具 |
| HTTP API | 想从你自己的后端读写 | 用 API Key 或 OAuth 令牌调用 REST API。见 HTTP API 参考 |
开源内核提供同样的 10 个 MCP 工具，所以你做的东西在自托管版上也能用。
用户数据放在哪
开始之前先选一种：
| 方式 | 怎么运作 | 取舍 |
|---|---|---|
| 每个用户有自己的 SaveSlot 账户（推荐） | 你的应用像 Agent 一样用 OAuth 请求授权。用户在「接入 Agent」里能看到你的应用，随时可以吊销 | 用户离开你的产品时，数据仍然归他们 |
| 数据放在你的账户里 | 在你的账户下给每个终端用户建一个 Slot，用 API Key 访问 | 起步更简单，但你的用户看不到、也带不走自己的数据 |
API Key
- 在「开发者 → API Key」里创建。起个名字，选只读或读写，再选它能访问的 Slot。一个 Key 只能访问一个 Slot。
- Key 只显示一次，请当场复制，之后无法再次显示。
- 用 Key 发起的调用会出现在「活动」里，并计入「用量」。
- 随时可以吊销，之后用它发起的调用都会失败。
Key 以 ss_ro_（只读）或 ss_rw_（读写）开头，作为 Bearer 令牌发送：
curl https://api.saveslot.ai/v1/slots/SLOT_ID/tables/meals/records \
-H "Authorization: Bearer ss_rw_…" \
-d '{"what": "Beef noodles", "calories": 650, "trust": "inferred"}'OAuth 应用
在「开发者 → OAuth 应用」里登记你的产品，你的用户就能从自己的 SaveSlot 账户授权它。回调地址必须以 https:// 开头；开发时可以用 http://localhost 和 http://127.0.0.1。见 OAuth 应用。
计费
开发者 API 按用量计费。请写信到 [email protected] 开通。