REST API 与令牌

除可视化构建器外，GetMyBot 还提供程序化访问：通过 REST API 管理机器人数据。有两类令牌——针对特定机器人的访问令牌和个人令牌（用于账户级别的自动化与集成）。

机器人 API 令牌

在 设置 → API 令牌 中创建。每个令牌绑定到一个机器人，允许访问其 REST 端点（反应、用户、集合、统计等）。令牌仅在创建时显示一次——请妥善保存；列表只显示名称、掩码和创建日期。请及时删除多余的令牌。

个人访问令牌（PAT）

个人访问令牌（PAT，以 mbp_ 开头）在账户级别生效，用于自动化和集成。在个人中心创建；通过 Authorization: Bearer mbp_… 请求头传递。令牌具有访问范围（scopes）——一组 资源:操作 权限（例如 reactions:read、bots:write），* 表示完全访问。有效期可限制，令牌以哈希形式存储。这是在不暴露密码的情况下为脚本提供受限访问的便捷方式。

API 可访问的内容

通过 API 可访问与界面相同的实体：机器人及其设置、反应（包括导入/导出）、订阅者与标签、集合与记录、统计与请求日志、群发。这允许你在 GetMyBot 之上构建自定义面板、同步和自动化。

渠道与 WhatsApp

GetMyBot 是多渠道的（Telegram + WhatsApp + VK），机器人的渠道同样可以通过 REST 管理。渠道和 WhatsApp 模板受 共享 scope bots:read / bots:write 控制——没有单独的渠道 scope。

  • GET /api/channels/capabilities — 渠道能力矩阵（会话端点，无需 PAT scope）。
  • GET /api/bots/{botID}/channels（bots:read）— 列出机器人的渠道。
  • POST /api/bots/{botID}/channels（bots:write）— 连接 WhatsApp 或 VK 渠道。
  • DELETE /api/bots/{botID}/channels/{channelID}（bots:write）— 断开渠道。
  • GET /api/bots/{botID}/channels/{channelID}/templates（bots:read）— 渠道的 WhatsApp 模板目录。
  • POST /api/bots/{botID}/channels/{channelID}/templates（bots:write）— 创建模板并提交给 Meta 审核。
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync（bots:write）— 从 Meta 重新同步目录。
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID}（bots:write）— 编辑模板。
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID}（bots:write）— 删除模板。
  • POST /api/bots/{botID}/channels/{channelID}/templates/media（bots:write）— 上传头部媒体示例（图片/视频/文档）。

请求/响应的结构、参数和示例见 API 参考。

移动端访问

平台有移动端应用，拥有独立的授权（access 和 refresh 令牌）及机器人汇总仪表盘——使用同一后端。

API 参考

完整的公开 API 交互式参考可在 API 参考 页面查看：列出了所有支持 PAT 的端点、参数、请求与响应 Schema、所需 scopes 及现成示例（curl、JavaScript、Python）。可直接在页面上用自己的令牌执行测试请求。

安全性

  • 令牌仅显示一次；请像保管密钥一样保存。
  • 机器人与凭据的密钥以加密形式存储。
  • 变更操作记录在审计日志中。

下一步