只读 API

身份验证

使用个人 Bearer 令牌访问只读分析 API。

创建 API 密钥#

在应用中打开设置 → API 密钥,创建令牌,并在显示时保存。使用包含 geo_ 前缀的完整值。

发送令牌#

cURL
curl --fail-with-body 'https://app.keptai.com/api/domains/example.com/agent-analytics?section=overview&days=30' \
  -H "Authorization: Bearer $KEPT_API_TOKEN"

示例使用占位值。请将 example.com 换为您可访问的项目域名,并将 KEPT_API_TOKEN 设置为您的个人 geo_ 令牌。

访问范围#

Bearer 令牌允许通过 GET 读取可见项目的 agent-analytics 与 scope-options 路由,不提供通用写入能力。目前没有 OAuth、公开项目创建、公开提示词写入或官方 SDK。MCP 使用同一类个人令牌。

处理错误#

状态码 含义 核查内容
400 域名、section 或筛选值无效 核对文档中的有效值。
401 未通过身份验证 核对 Bearer 请求头以及令牌是否已撤销。
404 域名不存在或不可访问 核对域名与项目权限。
502 筛选选项上游读取失败 根据情况稍后重试。

将令牌保存在服务端环境变量中,不要发布到浏览器脚本或 URL。请在设置中撤销不再使用的令牌。

搜索标题、指南和 API 参考。