为什么 REST API 很重要
新的 API 参考 让团队可以直接在 GanttFather 之上构建工具。不必先导出表格、在别处修改、再重新导入；你的脚本可以读取和写入团队在应用中看到的同一份项目数据。
这对运营团队、代理机构、创业者和内部工具开发者都很重要。甘特图越贴近真实工作，价值越大。API 让定时任务、仪表盘、客户门户、部署流水线和轻量集成都可以直接接入项目时间线。
你可以自动化什么？
第一版公开 API 聚焦在人们最常想自动化的项目数据：
- 列出你的 token 可以访问的项目
- 读取、创建、更新、重排和删除任务
- 保持状态和进度同步
- 设置负责人和任务依赖关系
- 列出成员和资源
- 创建、更新或移除设备、会议室、预算项等非人力资源
实际使用中，你可以从内部需求表单创建发布计划，在部署完成后更新里程碑，或把另一套工具中的部分工作映射到 GanttFather 时间线上。
如何开始
打开 GanttFather，进入 Settings → AI Agents & API，然后创建一个 token。接着：
- 阅读 authentication guide。
- 调用 list projects 找到项目 id。
- 用一个小测试项尝试 create task。
- 在运行批量同步任务之前，先了解 pagination 和 rate limits。
curl https://api.ganttfather.com/v1/projects \
-H "Authorization: Bearer glt_your_token" \
-H "User-Agent: your-integration-name/1.0"User-Agent 是有意要求的。它帮助支持团队追踪真实集成、调试边缘情况，并把 API 流量与匿名浏览器流量区分开。
API versus MCP
当你在写代码、需要稳定的 HTTP endpoint 时，使用 REST API。当你希望 Claude、ChatGPT、Cursor 或 Windsurf 这样的 AI 助手通过更高层工具操作项目时，使用 MCP server guide。
两者都使用 GanttFather 中同一个 token 区域，也都面向所有用户开放。区别在接口：REST 给你的程序使用；MCP 给你的智能体使用。
定价和限制
API 访问包含在所有计划中。pricing page 仍然遵循同一条规则：所有功能从第一天起都可用，付费升级只增加容量——更多你拥有的项目，或更多活跃编辑者。
默认 API 限制是每个 token 每分钟 60 次请求，以及每个 token 每天 5,000 次请求。被限流的请求会返回带有 Retry-After 的 429；每日配额响应会包含 X-Quota-Remaining。对于较大的同步任务，请批量写入，避免按字段循环更新。参见 Rate limits & quotas。
集成模式
最干净的集成通常遵循这个形状：
- 保存你的系统 id 与 GanttFather 任务 id 之间的小映射
- 写入之前先读取当前项目状态
- 只对发生变化的字段发送部分更新
- 在重试创建类操作时使用幂等键
- 出错时记录 GanttFather trace id
从小处开始：列出项目，创建一个任务，更新它，然后再把流程接入你自己的系统。
Start with a token，并把参考文档放在编辑器旁边。