跳到主要内容

API、OAuth 与 MCP

让外部工具在明确权限、配额与可审查范围内连接作品网络,同时分清楚已可使用与仍在规划的协议。

当前状态开发中

API、OpenAPI、权限政策、API 令牌认证与配额已实现;OAuth 应用授权和官方 MCP 连接尚未作为完整产品提供。

核心定位

开放连接不是把所有数据交给第三方。每个应用都必须明确知道自己能读什么、能写什么、代表谁执行、受到哪些配额限制,以及失败后如何恢复。

REZICS 的服务器路由与类型结构定义是唯一手写契约来源,再由它们生成 OpenAPI、类型客户端与文档。认证和权限则由服务器端类型化访问政策强制执行,不依赖界面隐藏按钮。

现在已经能做什么

  1. 通过公开 API 访问作品、内容、领域、进度与其他已开放能力。
  2. 使用服务器路由与类型结构定义生成一致的 OpenAPI 文档。
  3. 以会话或具权限范围的 API 令牌验证请求。
  4. 对不同操作应用配额、错误响应与服务器端访问政策。
  5. 使用生成的类型客户端与 @rezics/api 软件包。
  6. 对内容结构等复杂工作流保留并发令牌、请求上限与可恢复语义。

OAuth 与 MCP 的方向

OAuth 将让用户授权第三方应用,而不交出密码或长期个人令牌;MCP 则能让 AI 工具在用户看得懂、可撤回的范围内协助补充书籍、更新元数据或执行工作流。

最终目标是让不熟悉 API 的用户也能通过受控工具参与作品数据建设。但 OAuth 第三方应用、授权同意页面、回调、安全审查与官方 MCP 服务器尚未全部实现,因此能力状态标记为「开发中」。

大型内容工作流

以书籍内容结构为例,单次请求限制 10,000 个编译后逻辑变更,不限制整本书总节点数。大型网络小说导入必须分批、保存检查点、处理过期修订与不确定结果,不能把数十万节点塞进一个无界交易。

关系与边界

OpenAPI 描述传输契约,不自动描述所有多步骤任务。API 也不绕过产品权限;MCP 不会因为由 AI 调用就获取额外授权。每次跨网络、存储或缓存边界都必须重新验证数据与查看者权限。