# 使用多個版本

API 合約可讓您維護同一個 API 合約的多個版本，讓您在準備新版本變更的同時，能維持已發佈版本的穩定。

* 在生產環境中維護現有 API 版本，同時在新版本中引入破壞性變更。
* 從單一位置追蹤和管理已發布的版本。
* 在不影響現有版本的情況下進行 API 變更。

當您建立新版本時，所有內容都會複製到新版本。最新版本隨後即可獨立更新，而不會影響先前的版本。

僅最新版本可編輯，且您只能從該版本建立新版本。較舊版本為唯讀。

API 合約首頁會顯示您擁有的所有 API，以及與您共用的所有 API 版本。![API 合約首頁。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/api-designer-homepage.png)

## 建立新的 API 版本

建立現有 API 定義的新版本。

資訊備註

備註：

您只能從最新版本建立新版本。較舊的版本為唯讀，無法編輯或用來建立新版本。

您是此 API 的擁有者，或是此 API 至少一個版本的編輯者。

1. 在首頁上，前往您要建立新版本的 API。

   如有需要，您可以依名稱或擁有者篩選清單。
2. 開啟最新版本以檢視預覽，然後按一下建立新版本。

   ![Contacts API 與「建立新版本」按鈕的檢視畫面。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png)
3. 輸入新版本。
4. 按一下建立。

已建立您 API 的新版本，內容與最新版本相同。模擬與說明文件預設為停用。

## 將 API 版本發布至 Qlik Catalog

將 API 合約的版本發布至 Qlik 空間，讓協作者可以在 Qlik Catalog 中找到它。

您是 API 的擁有者或 API 版本的編輯者。

當您發布版本時，合約版本在 API 合約中會變為不可變且唯讀。若要進行變更，請從最新版本建立新版本，並繼續在新版本上作業。

1. 在首頁上，按一下您要發佈的版本以開啟預覽，然後按一下 發佈。

   ![Contacts API 與「發布」按鈕的檢視畫面。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png)
2. 在發布對話方塊中，選取您要發布該版本的 Qlik 空間。
3. 檢視版本預覽並輸入發布備註。
4. 按一下發布。

所選版本會發佈至選取的 Qlik 空間，並在 API 合約中成為唯讀。如果您需要再次編輯合約，請先建立新版本。

## 刪除 API 版本

您是此 API 的擁有者。

1. 在首頁上，按一下您要刪除的版本旁邊的 ![功能表](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) 按鈕，然後按一下 刪除。
2. 按一下刪除以確認。

已刪除選取的版本。如果您要刪除整個 API，您需要 刪除每個版本。

## 匯入版本內容

從現有合約匯入內容至 API 版本，取代或合併其目前的內容。

您是 API 的擁有者或 API 版本的編輯者。

使用此功能，特性從外部合約檔案更新版本，而無需建立新版本。版本識別碼會在整個匯入過程中保留。

這不同於[匯入定義](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/APIDesigner/ImportingDefinition.htm "將現有的 API 定義匯入至 API Contracts。")，這會在 API Contracts 中建立新的 API。

1. 針對您要更新的版本，開啟匯入版本內容。

   此操作不適用於唯讀版本。

   您可以從下列位置存取此動作：
   * 在首頁上，按一下版本旁邊的 ![功能表](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png)，然後按一下 匯入版本內容。

     ![選單按鈕中的「匯入版本內容」選項。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-2.png)
   * 在該版本的 預覽 上，按一下 ![功能表](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) > 匯入版本內容。

     ![版本詳細資料檢視](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-3.png)
   * 在版本編輯器中，按一下 編輯 > 匯入版本內容。

     ![版本編輯器中的匯入版本內容選項。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content.png)
2. 選取要匯入合約的格式與來源。

   您可以從本機檔案、URL，或是直接貼至對話方塊中的 文字進行匯入。
3. 在 行為 下，選取如何套用匯入的內容。
   * 取代：使用匯入的合約覆寫所有目前內容。API 名稱、版本識別碼與規格版本均會予以保留。
   * 合併：將匯入的內容與現有版本的內容合併。API 名稱與版本識別碼會予以保留。如果匯入的元素與現有元素同名，匯入的元素將會加上 \_merge 字尾重新命名 (例如 User\_merge)。重複的 base URL 與媒體類型 將會略過。

   ![匯入版本內容對話方塊。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-dialobox.png)
4. 按一下匯入。

版本編輯器隨即開啟，並已套用更新後的內容。