Qoder Cloud Agents CN API は、クラウドでホストされる AI エージェントの完全な管理機能を提供し、エージェントの作成、環境設定、セッション管理、イベントストリーミングなどをカバーします。すべてのエンドポイントは REST 規約に従い、リクエストとレスポンスには JSON を使用します。
説明 この API は現在ベータ版です。一部の機能は将来のリリースで変更される可能性があります。
ゲートウェイ URL
| 環境 | URL |
|---|---|
| 本番 |
バージョニング
API は現在バージョン v1 です。すべてのエンドポイントは /v1/ URL プレフィックスでバージョニングされます。追加のバージョンヘッダーは必要ありません。
利用可能な API
| リソース | 説明 | ベースパス |
|---|---|---|
| エージェント | エージェントの CRUD とアーカイブ | |
| 環境 | ランタイム環境の設定 | |
| セッション | エージェントセッションの作成とライフサイクル | |
| イベント | セッションイベントストリームの読み取りとプッシュ | |
| ファイル | ファイルのアップロードと関連付け | |
| ボールト | 機密性の高い認証情報のためのセキュアストレージ | |
| スキル | エージェントスキルの登録と管理 | |
| メモリストア | 永続的なメモリストレージ |
リクエストサイズの制限
- 最大リクエストボディサイズ：4 MB
- この制限を超えるリクエストは切り捨てられ、JSON の解析に失敗して
400 invalid_request_error(メッセージ: "Request body must be valid JSON.") が発生します。
必須ヘッダー
すべての API リクエストには認証ヘッダーを含める必要があります。Content-Type は推奨されますが、必須ではありません。サーバーは自動検出できます。
Authorization: Bearer $QODER_PAT
Content-Type: application/json # 推奨されますが必須ではありません。サーバーは自動検出できますベータ版のステータス
- API サーフェスは概ね安定していますが、シグネチャは将来のイテレーションで微調整される可能性があります。
- 新しい機能は、新しいベータ版識別子を使用して提供されます。
- 本番環境で実行する場合は、API バージョンをロックし、互換性ハンドリングを追加してください。
- 現在のすべての機能は、追加のベータヘッダーなしで利用できます。
クイック接続チェック
# 現在のアカウント配下のエージェントを一覧表示します (認証と接続性を検証)
curl -s https://api.qoder.com.cn/api/v1/cloud/agents?limit=1 \
-H "Authorization: Bearer $QODER_PAT"成功したレスポンス：
{
"data": [],
"first_id": null,
"last_id": null,
"has_more": false
}レート制限
現在、API アプリケーションレイヤーにはアクティブなレート制限はありません。ゲートウェイレイヤーにはグローバルなバーストトラフィック抑制と DDoS 保護があり、トリガーされると 429 または 503 を返すことがあります。クライアントは、5xx/429 エラーに対してエクスポネンシャルバックオフによる再試行 (1 秒 → 2 秒 → 4 秒、最大 3 回) を実装する必要があります。