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 キーの作成
- サイドバーで API Keys に移動します。
- Create API Key をクリックします。
- 分かりやすい名前を入力します。
- キーをコピーします — 二度と表示されません!
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}/launch | IDE、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 呼び出し |
|---|---|---|
| Free | 3 | 1,000 |
| Pro | 10 | 50,000 |
| Ultra | 30 | 500,000 |
| Enterprise | 無制限 | 無制限 |
現在の使用量は Account → Account タブ → Plan limits で確認できます。
セキュリティ
- キーは保存前にハッシュ化されます — キーを取得することはできません。
- API Keys ページからいつでもキーを取り消せます。
- 各キーは特定の権限にスコープできます。
- API キーは、自身のマシンとセッションに対するクラウド自動化のためのものです。機密性の高い設定変更に対するアカウントセキュリティチェックを回避するためのものではありません。
- キーの作成や取り消しは、クラウドダッシュボードで最近のログインによって保護されたアクションなので、古いブラウザセッションは変更が成功する前に再認証が必要になることがあります。
