数据源与密钥

除现成的集成外，GetMyBot 还可通过连接器（数据源部分）和凭据（密钥部分）与任意 HTTP API 交互。连接器描述访问哪里，密钥描述如何授权。它们被"查询数据源"和"写入数据源"动作使用。

连接器（数据源）

数据源 → 连接器。连接器包含名称、类型、基础 URL、绑定的凭据和请求头：

  • REST — 任意 HTTP/JSON API。
  • OzmaDB — OzmaDB/FunDB 实例；基础 URL 填写实例 REST API 的根地址，对匿名视图的查询已简化。
  • IMAP — 标记为"即将推出"。

验证按钮发送测试请求并显示状态和延迟（或错误）——方便确认 URL 和密钥是否正确。

凭据（密钥）

密钥 → 凭据。密钥以加密形式存储。类型：

  • API 密钥 — 密钥 + 请求头名称（默认 Authorization）。
  • Bearer 令牌 — Authorization: Bearer 请求头中的令牌。
  • OAuth2（密码模式） — Token URL、Client ID/Secret、登录名、密码、scope。
  • OAuth2（刷新模式） — Token URL、Client ID/Secret、refresh 令牌、scope。

对于 OAuth2，平台会自动获取并缓存令牌，在过期或收到 401 响应时刷新；refresh 令牌的轮换会被保存。编辑时，密钥字段留空表示"不修改"。

在反应中读写数据

  • 查询数据源（ds_query）——通过连接器将数据读入 ctx：指定路径、到数组的 JSONPath 和结果的 ctx 键。之后可用列表循环遍历数组。
  • 写入数据源（ds_write）——以 JSON 格式发送数据（POST/PUT/DELETE）。

对于无需保存连接器的一次性请求，可使用Web 请求动作；下载页面文本则使用加载 URL（参见动作）。

下一步