查詢 Agent 版本列表

支援查詢目標 Agent 的版本歷史列表。

該 API 使用目標 Agent 自身的 API Key 進行驗證，僅允許已開啟版本管理權限的 Agent 調用。

請求方式

GET

調用地址

https://api.${endpoint}/v1/agent/version/list

調用驗證

詳情請參閱 API 概述的驗證方式說明。請使用目標 Agent 的 API Key 作為 token。

請求

請求範例

curl -X GET 'https://api.${endpoint}/v1/agent/version/list' \ -H 'Authorization: Bearer ${token}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/agent/version/list' \
  -H 'Authorization: Bearer ${token}'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	說明
Authorization	Bearer ${token}	使用目標 Agent 的 API Key 進行調用驗證。

請求參數

無。

回應

回應內容

{ "code": 0, "message": "OK", "data": [ { "id": "bv-xxxx", "bot_id": "bot-xxxx", "create_time": 1786327712000, "release_time": 1786327812000, "version": "v2", "version_desc": "Update prompt and tools", "version_status": "PUBLISHED", "creator_email": "owner@example.com" } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "id": "bv-xxxx",
      "bot_id": "bot-xxxx",
      "create_time": 1786327712000,
      "release_time": 1786327812000,
      "version": "v2",
      "version_desc": "Update prompt and tools",
      "version_status": "PUBLISHED",
      "creator_email": "owner@example.com"
    }
  ]
}

此代碼塊在浮窗中顯示

成功回應

欄位	類型	說明
id	String	版本記錄 ID。
bot_id	String	Agent ID。
create_time	Long	版本建立時間，毫秒時間戳。
release_time	Long	發布時間，毫秒時間戳；未發布時為空。
version	String	版本號。
version_desc	String	版本說明。
version_status	String	版本狀態。
creator_email	String	建立者電子郵件。

失敗回應

欄位	類型	說明
code	int	錯誤碼。
message	string	錯誤訊息。

狀態碼

狀態碼	說明
200	成功
401	未授權
403	權限不足或 API Key 未開啟版本管理權限
429	請求過於頻繁
500	伺服器錯誤