Qoder Cloud Agents API は、認証に個人アクセストークン (PAT) を使用します。すべての API リクエストには、HTTP ヘッダーに有効な PAT を含める必要があります。
PAT の取得
Qoder CN Console にサインインします。
[Settings] → [API Tokens] に移動します。
[Create Token] をクリックし、名前とスコープを設定します。
生成されたトークン (一度しか表示されません) をコピーし、安全な場所に保管してください。
PAT は pt- プレフィックスで始まります。たとえば、pt-your-token-here です。決してトークンをコードリポジトリにコミットしたり、公開したりしないでください。
Bearer ヘッダー形式
Bearer スキームを使用して、Authorization ヘッダーで PAT を渡します:
Authorization: Bearer pt-your-token-here
リクエスト例：
# エージェントリストの取得
curl -s "https://api.qoder.com.cn/api/v1/cloud/agents" \
-H "Authorization: Bearer $QODER_PAT"
環境変数の設定 (推奨)
PAT をハードコーディングしないように、環境変数として保存してください：
# ~/.bashrc または ~/.zshrc に追加
export QODER_PAT="pt-your-token-here"
# 設定の確認
curl -s "https://api.qoder.com.cn/api/v1/cloud/agents?limit=1" \
-H "Authorization: Bearer $QODER_PAT"
セキュリティに関する推奨事項
開発、テスト、本番の各環境用に、個別の PAT を作成してください。
トークンは定期的にローテーションしてください。
トークンのスコープを割り当てる際は、最小権限の原則を適用してください。
トークンが侵害された場合は、直ちにコンソールでそのトークンを失効させてください。