API キー
Cloud Only
API キーは Cloud バージョン でのみ利用可能です。
API キーを使うと、外部サービス、スクリプト、または統合から ADHDev の REST API にアクセスできます。
API キーの作成
サイドバーの API を開き、キーに名前を付けてスコープを選び、キーをコピーします — 表示されるのは一度だけです。
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/{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 ページ（または REST API）からいつでも取り消せます
- 各キーは特定の権限にスコープできます。
- API キーは、自身のマシンとセッションに対するクラウド自動化のためのものです。機密性の高い設定変更に対するアカウントセキュリティチェックを回避するためのものではありません。
- キーの作成や取り消しは、最近のログインによって保護されたアクションなので、古いブラウザセッションは変更が成功する前に再認証が必要になることがあります。