只读 API
身份验证
使用个人 Bearer 令牌访问只读分析 API。
创建 API 密钥#
在应用中打开设置 → API 密钥,创建令牌,并在显示时保存。使用包含 geo_ 前缀的完整值。
发送令牌#
curl --fail-with-body 'https://app.keptai.com/api/domains/example.com/agent-analytics?section=overview&days=30' \
-H "Authorization: Bearer $KEPT_API_TOKEN"
const response = await fetch(
'https://app.keptai.com/api/domains/example.com/agent-analytics?section=overview&days=30',
{ headers: { Authorization: `Bearer ${process.env.KEPT_API_TOKEN}` } }
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
import json, os, urllib.request
request = urllib.request.Request(
'https://app.keptai.com/api/domains/example.com/agent-analytics?section=overview&days=30',
headers={'Authorization': 'Bearer ' + os.environ['KEPT_API_TOKEN']}
)
with urllib.request.urlopen(request) as response:
print(json.load(response))
示例使用占位值。请将 example.com 换为您可访问的项目域名,并将 KEPT_API_TOKEN 设置为您的个人 geo_ 令牌。
访问范围#
Bearer 令牌允许通过 GET 读取可见项目的 agent-analytics 与 scope-options 路由,不提供通用写入能力。目前没有 OAuth、公开项目创建、公开提示词写入或官方 SDK。MCP 使用同一类个人令牌。
处理错误#
| 状态码 | 含义 | 核查内容 |
|---|---|---|
| 400 | 域名、section 或筛选值无效 | 核对文档中的有效值。 |
| 401 | 未通过身份验证 | 核对 Bearer 请求头以及令牌是否已撤销。 |
| 404 | 域名不存在或不可访问 | 核对域名与项目权限。 |
| 502 | 筛选选项上游读取失败 | 根据情况稍后重试。 |
将令牌保存在服务端环境变量中,不要发布到浏览器脚本或 URL。请在设置中撤销不再使用的令牌。