API 版本管理
API 只有在發布后才能被訂閱方使用。創建后的 API 可以根據業務需求進行編輯、下線和編輯重發布等操作。新版本發布上線后,老版本自動成為歷史版本被下線。
API 版本的生命周期如下:
版本說明:
每次發布一個版本時,系統為當前版本分配一個新的版本號。
每次保存草稿時,系統為未發布草稿分配一個新的版本號。
同一 API 只能存在一個編輯中版本。新保存的草稿自動覆蓋未發布的已有草稿。
查看版本
在 API 管理 頁面,單擊目標 API 進入其詳情頁。在 版本管理 標簽頁下,您可以查看到當前線上版本、編輯中版本以及歷史發布版本,如下圖所示。
發布版本
您可以對線上版本與歷史版本重新編輯再發布,也可以直接發布編輯中的版本。
重新編輯并發布線上版本
在 版本管理 > 線上版本 中,單擊 操作 列的 重新編輯 按鈕。
在編輯頁面,修改 API 信息后,單擊 保存。
在 API 編輯的內容保存成功頁面,單擊 立即發布。
在 發布 窗口,您可以選擇輸入具體版本原因后單擊 確定,即可發布成功。
發布編輯中版本
在 版本管理 > 編輯中版本 中,單擊 操作 列的 發布 按鈕。
在 發布 窗口,輸入具體版本原因,單擊 確定,即可發布成功。
編輯重發布歷史版本
在 版本管理 > 歷史版本 中,單擊 操作 列的 編輯重發布 按鈕。
在編輯頁面,修改 API 信息后,單擊 保存。
在 API 編輯的內容保存成功頁面,單擊 立即發布。
在 發布 窗口,您可以選擇輸入具體版本原因,單擊 確定,即可發布成功。
下線版本
您可以將處于已發布狀態的 API 下線。下線后, API 狀態切換為 未發布,無法被該 API 的訂閱方應用繼續調用。您可以通過以下任一方法下線 API 當前版本:
在 API 列表中選擇要下線的 API,單擊 下線 > 確認。
在 API 詳情頁面,單擊右上角的 下線 按鈕。
在 API 詳情 > 版本管理 頁簽中,單擊 線上版本 右側的 下線 按鈕。