每个按钮,都是一次 API 操作。

REZICS 网站本身就调用这套 API。你的程序发送 HTTP 请求,AI 代理通过 MCP 服务器调用工具,最终执行的都是同一项操作。

暖白色纸面上,三条纸带分别从上方、右侧和下方伸来,末端都压在同一张深蓝灰色纸片下。

三种方式

通过三种方式,得到同一份响应。

在书架页面点击“下载书架”,网站发送的就是这个请求。你的程序和代理发送相同的请求,经过同样的检查,得到同一份书架导出文件。

  • 用户

    在 REZICS 的书架页面,点击“下载书架”。

  • 程序

    GET /v1/me/library-export
      ?actingSubject=…&limit=20
    Authorization: Bearer …
  • 代理

    {
      "name": "library_export",
      "arguments": {
        "query": {
          "actingSubject": "…",
          "limit": 20
        }
      }
    }
    tools/call 的参数。身份由你指定。

同一项操作

operationId
  getV1MeLibrary-export
profile
  rezics-library-export-v1

REZICS 网站不直接访问数据库,所有读写都通过 API;网站能做的事,API 也都能做到。

规则

从哪里接入,规则都一样

  • 同一个身份

    actingSubject

    写入时注明本次以哪个身份操作。访问令牌不会替你选择身份,服务器每次都会重新检查。

  • 同一权限上限

    scope

    应用程序和代理获得的权限只会少于用户本人,不会更多。

  • 同一张回执

    Idempotency-Key

    写入请求带有幂等键。超时后用同一个请求重试,会得到原来的结果,不会重复执行。

  • 同一套代码

    application/problem+json

    失败时返回问题详情,code 字段固定,程序按代码处理,无需解析消息。

索引

其他人制作的工具,也有索引

REZICS 也为其他人的 MCP 服务器、Skill 和 API 建立索引,收录版本、来源、测试或使用记录、评分和讨论。

用同一套 API,打造自己的工具。

让自己的程序读写作品、书架和社区数据。每次操作都遵循 REZICS 的身份与授权规则。