REST API が重要な理由
新しい API reference により、チームは GanttFather の上に直接ツールを構築できます。スプレッドシートを書き出し、別の場所で編集し、また取り込む代わりに、スクリプトがアプリでチームが見ている同じプロジェクトデータを読み書きできます。
これはオペレーションチーム、代理店、創業者、社内ツール開発者にとって重要です。ガントチャートは実際の仕事に近いほど役に立ちます。API により、cron job、ダッシュボード、顧客ポータル、デプロイパイプライン、軽量な連携からタイムラインを扱えます。
何を自動化できますか?
最初の公開 API は、最も自動化されやすいプロジェクトデータに集中しています。
- token がアクセスできるプロジェクトを一覧する
- タスクを読み取り、作成、更新、並べ替え、削除する
- ステータスと進捗を同期したままにする
- 担当者とタスク依存関係を設定する
- メンバーとリソースを一覧する
- 機材、部屋、予算行などの非人的リソースを作成、更新、削除する
実際には、社内フォームからローンチ計画を作成したり、デプロイ完了時にマイルストーンを更新したり、別ツールの一部の作業を GanttFather のタイムラインへ反映できます。
始め方
GanttFather を開き、Settings → AI Agents & API に移動して token を作成します。その後:
- authentication guide を読みます。
- list projects を呼び出して project 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 traffic と匿名ブラウザ traffic を区別するために役立ちます。
API versus MCP
コードを書いていて安定した HTTP endpoint が必要な場合は REST API を使います。Claude、ChatGPT、Cursor、Windsurf などの AI assistant に高レベルな tools を通じてプロジェクトを扱わせたい場合は、MCP server guide を使います。
どちらも GanttFather の同じ token area を使い、すべてのユーザーに含まれます。違いは interface です。REST はあなたの program 用、MCP はあなたの agent 用です。
価格と制限
API access はすべてのプランに含まれます。pricing page は同じルールのままです。すべての機能は初日から利用でき、有料アップグレードは容量だけを増やします。つまり、所有するプロジェクトを増やすか、active editor を増やすだけです。
既定の API limit は、token ごとに 1 分あたり 60 request、および token ごとに 1 日あたり 5,000 request です。制限された request は Retry-After 付きの 429 を返します。日次 quota の応答には X-Quota-Remaining が含まれます。大きな sync では write を batch 化し、field ごとの update loop を避けてください。詳しくは Rate limits & quotas を参照してください。
連携パターン
きれいな連携は、たいてい次の形になります。
- 自分の system id と GanttFather task id の小さな mapping を保持する
- 書き込む前に現在の project state を読む
- 変更された field だけ partial update を送る
- retry する create-style operation では idempotency key を使う
- 失敗時には GanttFather trace id を log する
小さく始めましょう。projects を list し、task を 1 つ作り、更新し、その後で自分の system に flow を接続します。
Start with a token し、reference を editor の横に開いておきましょう。