# API 参考

## 创建只读令牌
在控制台「开发者」中创建个人令牌，指定名称、1–90 天有效期和必要权限。完整令牌只显示一次。最多保留 10 个有效令牌；请通过安全的环境变量传递，不提交到仓库或提示词。
## 读取活动
```http
GET /v1/developer/activities?limit=25
Authorization: Bearer YOUR_PERSONAL_TOKEN
```
响应：
```json
{"schema_version":1,"items":[],"total":0,"next_offset":null}
```
支持 q 名称搜索、from/to 日期筛选、offset 偏移量和 limit 分页大小。完整字段见[数据格式](/zh/docs/formats)。
## 导出
```http
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](/openapi.json)、[llms.txt](/llms.txt)，或在文档页面复制 Markdown。自动化工具和 AI Agent 使用相同的只读令牌与权限。