查询 Workflow 版本列表

支持查询目标 Workflow 的版本历史列表。

该接口使用目标 Workflow 自身的 API Key 鉴权，只允许开启版本管理权限的 Workflow 调用。

请求方式

GET

调用地址

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

调用验证

详情参见 API 概述的鉴权方式说明。请使用目标 Workflow 的 API Key 作为 token。

请求

请求示例

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

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

此代码块在浮窗中显示

请求头

字段	类型	说明
Authorization	Bearer ${token}	使用目标 Workflow 的 API Key 进行调用验证。

请求参数

无。

响应

响应体

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

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

此代码块在浮窗中显示

成功响应

字段	类型	说明
id	String	版本记录 ID。
bot_id	String	Workflow 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	服务器错误