API 参考

创建只读令牌

在控制台「开发者」中创建个人令牌，指定名称、1–90 天有效期和必要权限。完整令牌只显示一次。最多保留 10 个有效令牌；请通过安全的环境变量传递，不提交到仓库或提示词。

读取活动

GET /v1/developer/activities?limit=25
Authorization: Bearer YOUR_PERSONAL_TOKEN

响应：

{"schema_version":1,"items":[],"total":0,"next_offset":null}

支持 q 名称搜索、from/to 日期筛选、offset 偏移量和 limit 分页大小。完整字段见数据格式。

导出

GET /v1/developer/export?format=csv
Authorization: Bearer YOUR_PERSONAL_TOKEN

需要 data:export 权限。导出不支持 offset 或 limit；超出 10000 条返回 413，按日期拆分。

错误与限流

401 表示令牌无效、过期或撤销；403 表示权限不足；400 表示参数无效；429 表示每个令牌每分钟 60 次的窗口额度用尽；503 表示存储或服务暂不可用。不要对 401/403 无限重试。429 等待至少一分钟；503 使用有上限的退避。

机器可读入口

可获取 OpenAPI 3.1、llms.txt，或在文档页面复制 Markdown。自动化工具和 AI Agent 使用相同的只读令牌与权限。