Skip to content

API キー

フリーズされたサーフェス(ダッシュボード UI)

クラウドダッシュボードの専用 API Keys ページは、現在明示的な製品決定(2026-07-14、リポジトリの docs/FROZEN_SURFACES.md 参照)によってフリーズされています: サイドバーエントリが非表示になっており、/api-keys/dashboard にリダイレクトされます。以下に説明する API キーのバックエンド、既存のキー、および REST API はライブで保持されていますが、フリーズが解除されるまで新しい API キー UI の機能開発は予定されていません。REST API またはサポートを通じて API キーを管理してください。

Cloud Only

API キーは Cloud バージョン でのみ利用可能です。

API キーを使うと、外部サービス、スクリプト、または統合から ADHDev の REST API にアクセスできます。

API キーの作成

  1. サイドバーで API Keys に移動します。
  2. Create API Key をクリックします。
  3. 分かりやすい名前を入力します。
  4. キーをコピーします — 二度と表示されません!

API キーは、識別しやすいように adk_ プレフィックスが付きます。

API キーの使用

Authorization ヘッダーにキーを含めてください:

bash
curl -H "Authorization: Bearer adk_your_key_here" \
     https://api.adhf.dev/api/v1/daemons

利用可能なエンドポイント

メソッドエンドポイント説明
GET/api/v1/daemons接続されたマシンの一覧
GET/api/v1/daemons/{daemonId}/status現在のマシンのスナップショットを読む
POST/api/v1/shortcuts/{daemonId}/launchIDE、CLI、または ACP ターゲットを起動
POST/api/v1/shortcuts/{ideId}/chatエージェントにメッセージを送信
POST/api/v1/shortcuts/{ideId}/approveアクションを承認または拒否
GET/api/v1/shortcuts/{ideId}/chat現在のチャットを読む
GET/POST/api/v1/shortcuts/{ideId}/chat/debugサニタイズされたチャットのデバッグバンドルをビルド
GET/api/v1/shortcuts/{ideId}/status現在のエージェントのステータスを読む

完全な API リファレンス →

プラン制限

プランAPI キー数月間 API 呼び出し
Free31,000
Pro1050,000
Ultra30500,000
Enterprise無制限無制限

現在の使用量は Account → Account タブ → Plan limits で確認できます。

セキュリティ

  • キーは保存前にハッシュ化されます — キーを取得することはできません。
  • API Keys ページからいつでもキーを取り消せます。
  • 各キーは特定の権限にスコープできます。
  • API キーは、自身のマシンとセッションに対するクラウド自動化のためのものです。機密性の高い設定変更に対するアカウントセキュリティチェックを回避するためのものではありません。
  • キーの作成や取り消しは、クラウドダッシュボードで最近のログインによって保護されたアクションなので、古いブラウザセッションは変更が成功する前に再認証が必要になることがあります。

ホスティングされたクラウドのドキュメントはこちらです。オープンソースおよびセルフホストのドキュメントは OSS リポジトリにあります。