GanttFather API トークンを作成し、v1 REST API を安全に呼び出し、クォータと冪等性を処理し、REST と MCP のどちらかを選択します。
GanttFather REST API は、スクリプトと統合のバージョン管理されたプロジェクト、タスク、依存関係、メンバー、およびリソースの操作を公開します。 GanttFather トークンで認証し、空ではない User-Agent ヘッダーを送信し、読み取り呼び出しを開始して、再試行可能なタスクまたはリソースを作成するときに冪等性キーを使用します。
API の動作は 2026 年 8 月 7 日に確認されました。 ライブ API リファレンス エンドポイントレベルの契約として。
GanttFather API を使用して何を自動化できますか?
v1 API は、一般的なスケジュール統合ワークフローをサポートしています。
- アクセス可能なプロジェクトをリストし、1 つのプロジェクトを検査します
- タスク、メンバー、リソース、依存関係のリストと読み取り
- タスクの作成、部分更新、並べ替え、および削除
- タスクの依存関係を追加または削除します
- リソースの作成、更新、削除
- 外部レコードと GanttFather ID の間に独自のマッピングを添付します
パブリック API は、ブラウザの内部 API と同じ表面ではありません。文書化された v1 エンドポイントと応答フィールドのみを使用してください。
API トークンはどのように作成して使用しますか?
GanttFather を開き、[設定] → [AI エージェント & API] に移動し、最小の有用なスコープと権限を持つトークンを作成します。生のトークンが表示されたらそれをコピーし、シークレット マネージャーに保存します。 GanttFather は、後で表示するために生の値を保存しません。
次に、次のシーケンスに従います。
- を読んでください。 認証ガイド。
- 電話をかける プロジェクトをリストする アクセス可能なプロジェクト ID を見つけます。
- 書き込みを試みる前にタスクを読み取ります。
- 使い捨てテスト タスクを 1 つ作成します。
- 一括ジョブの前に、ページネーション、再試行、およびクォータ処理を追加します。
すべてのリクエストには、ベアラー トークンと、クライアントを識別する空でないユーザー エージェントが含まれている必要があります。欠落しているユーザー エージェントは、通常のエンドポイント処理の前に拒否されます。
書き込みに重要な安全ルールはどれですか?
部分的な更新は、統合が所有するフィールドに対してのみ使用してください。現在の状態を変更する前に読み取り、安定した ID とトレース情報を記録し、すべての外部フィールドを無条件上書きにしないでください。
タスクとリソースの作成では、タイムアウトまたはネットワーク障害により再試行が発生する可能性がある場合に、Idempotency-Key を送信します。同じリクエストでキーを再利用すると、前の結果が返されます。別のリクエストでそれを再利用すると競合が発生します。更新と削除には文書化されたセマンティクスがあり、その作成専用キーを普遍的な重複排除メカニズムとして受け入れません。
依存関係と階層は別の問題です。並べ替えは、親の配置を変更するための認可された方法です。依存関係エンドポイントは、先行関係をモデル化します。一方からもう一方を導き出すのではなく、両方を検証します。
レートと 1 日あたりの割り当て制限は何ですか?
デフォルトの保護は、認証されたトークンごとに 1 分あたり 60 リクエスト、トークンごとに 1 日あたり 5,000 リクエストです。限定された応答では HTTP 429 が使用され、再試行情報が提供されます。現在を確認してください レート制限とクォータのドキュメント 運用上の制限は変更される可能性があるため、運用ワークロードを計画する前に検討してください。
正しくページ分割し、バッチで読み取り、安定した ID をキャッシュし、フィールドごとの一連の更新ではなく 1 つの部分的な更新を送信することで、リクエストの量を削減します。再試行ループは Retry-After を尊重し、ジッターのある制限付き指数バックオフを使用する必要があります。
MCP の代わりに REST を使用する必要があるのはどのような場合ですか?
決定論的なアプリケーション コードで、バージョン管理された HTTP リソース、明示的なエラー応答、および制御された再試行動作が必要な場合は、REST を使用します。を使用します。 MCP サーバー Claude などの AI クライアントが Model Context Protocol を通じて高レベルのプロジェクト ツールを呼び出す必要があるとき。
どちらも GanttFather のトークン レーンを使用できますが、それらの操作と冪等性入力は互換性がありません。 API 統合は REST 参照に従う必要があります。エージェントは MCP ツールの説明に従う必要があります。
安全な最初の統合パターンとは何ですか?
各フィールドに対して 1 つの方向と 1 人の所有者から始めます。
| ステップ | 推奨される動作 |
|---|---|
| 発見する | プロジェクトをリストし、選択したプロジェクト ID を記録します |
| 読む | 現在のタスクをページ単位で確認し、ID マップを構築する |
| 比較する | 書き込みを行わずに変更セットを計算する |
| レビュー | 意図した作成、更新、削除をログに記録します |
| 書く | サポートされている最小の突然変異を適用する |
| 検証する | 結果を読み取り、返された ID を記録します |
競合の所有権、削除ルール、再試行、およびリカバリが定義されるまでは、「同期」を要求しないでください。
GanttFather API をいつ構築する必要がありますか?
API は、フォーム、デプロイ パイプライン、カスタマー ポータル、または内部システムが、チームが GanttFather で参照しているのと同じプロジェクト データに繰り返しアクセスする必要がある場合に使用します。最も信頼性の高い最初のユースケースは狭いものであり、たとえば、展開後にリリースマイルストーンを作成し、実際の失敗と再試行を観察した後に拡張します。
API は、どのシステムがフィールドを所有するかを決定したり、複数システムのワークフローを競合させたりすることはありません。統合ではこれらのルールを定義する必要があります。
GanttFather プロジェクトを作成する、最小特権トークンを発行し、本番レコードを接続する前に使い捨てデータに対してテストします。
よくある質問
API のアクセスは無料利用枠に含まれますか?
API アクセスは現在、GanttFather プラン全体で利用可能です。容量と保護の制限は引き続き適用されます。を確認してください 価格ページ 現在の条件に関する API クォータのドキュメント。
GanttFather API トークンはどのようなものですか?
トークンは GanttFather トークン形式を使用し、Bearer 資格情報として提示されます。トークンをソース管理にコミットしたり、公開ログに含めたりしないでください。
ユーザーエージェントはオプションですか?
通常の v1 リクエストの場合はいいえ。製品名やバージョンなど、統合を識別する空でない値を送信します。
すべてのリクエストに冪等性キーを含める必要がありますか?
いいえ。同じリクエストが再試行される可能性がある場合に、文書化された作成操作に使用します。これは汎用バージョンまたは同時実行ヘッダーではありません。
API は Azure DevOps 統合ソースを構成できますか?
パブリック v1 プロジェクト データ API と製品の Azure DevOps 統合は別個のサーフェスです。文書化されていない統合エンドポイントが存在すると想定しないでください。
OpenAPI ドキュメントはどこにありますか?
から始めてください GanttFather API の紹介 認証、エンドポイント、スキーマ、エラーについては参照リンクをたどってください。
