SaveSlot 文档

开发者

OAuth 应用

OAuth 应用让用户把你的产品连到他们自己的 SaveSlot 账户,方式和连接 Claude、ChatGPT 一样。他们选择你的应用能访问哪些 Slot,之后可以修改,也可以在「接入 Agent」里吊销。

登记应用

  1. 在工作台打开「开发者 → OAuth 应用」。
  2. 填写应用名称和回调地址。回调地址必须以 https:// 开头;开发时可以用 http://localhost 和 http://127.0.0.1。
  3. 点「登记应用」。工作台会显示应用的 client id。

在同一个列表里可以删除应用,已授权的用户会随之断开。

授权流程 草案

SaveSlot 采用 OAuth 2.1 + PKCE:

  1. 你的应用把用户带到授权页:
https://app.saveslot.ai/oauth/authorize
  ?client_id=ss_app_…
  &redirect_uri=https://yourapp.example/callback
  &response_type=code
  &state=…
  &code_challenge=…&code_challenge_method=S256
  1. 用户(需要时先登录)看到你的应用名称、回调域名和你将得到的权限,选择允许或拒绝。
  2. SaveSlot 带着 code 和 state 跳回你的 redirect_uri。拒绝时返回 error=access_denied。
  3. 你的后端用 code_verifier 在 POST https://api.saveslot.ai/v1/oauth/token 换取访问令牌和刷新令牌。

用户批准什么

授权页的选项和 Agent 一样:全部 Slot 或指定 Slot,每个 Slot 只读或读写,以及能否新建表、删除数据。你的应用可以请求更窄的初始范围,用户也总能再收窄。见 Agent 权限。

待定问题 草案