# 將 API 版本推送至 GitHub

將您的 API 連結至 GitHub 存放庫，並以 OAS/Swagger 或 RAML 推送您的 API 定義。

* 您擁有 GitHub 帳戶和存放庫。
* 您的瀏覽器受到 GitHub 支援 (由於 GitHub 已不再支援 Internet Explorer 11，因此 API Contracts 不支援 IE11 的此功能，特性)。

1. 如果您的 GitHub 帳戶尚未連結至您的 API Contracts 帳戶，請前往 API Contracts 設定。
2. 按一下連結您的 GitHub 帳戶。

   ![API Contracts 設定中的 GitHub 帳戶區段。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/link-your-github-account.png)
3. 在開啟的視窗中，登入 GitHub 並按一下 授權 Talend，以允許 API 合約 存取您的 GitHub 帳戶。

   資訊備註警告：若您使用的是 Internet Explorer 11，系統會提示您升級至最新版本的 Microsoft Edge、Google Chrome 或 Firefox。

   您的 GitHub 帳戶現已連結至您的 API Contracts 帳戶，您可以開始將您的 API 定義推送至 GitHub。
4. 開啟您要推送至 GitHub 的 API 版本。
5. 按一下右上角的連結。
6. 在編輯 GitHub 設定區段中，啟用該選項並編輯以下欄位：
   * 擁有者
   * 存放庫
   * 分支
   * 路徑
   * 格式

   資訊備註附註：如果您的 API 有多個版本，每個版本都可以有不同的 GitHub 設定。

   ![編輯 API 設定檢視的 GitHub 設定區段。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/push_to_github_01_link.png)
7. 儲存設定後，按一下 推送。

   當您的專案包含尚未推送至 GitHub 的變更時，Push 右側會顯示一個綠點。![當專案包含尚未推送至 GitHub 的變更時的螢幕截圖。](https://help.qlik.com/zh-TW/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/push_to_github_03_push.png)
8. 輸入提交訊息並視需要輸入標籤，然後按一下 推送。

   標籤應為唯一，且應追蹤下列規則：
   * 僅能包含英數字元以及下列特殊字元：\_、-、. 和 /。
   * 不能以特殊字元開頭或結尾。
   * 不得包含下列字元模式： ..、// 及 /.。

您所選取的 API 定義版本已推送至您的存放庫。產生的檔案名稱包含 API 名稱與版本。

您可以按一下 在 GitHub 上檢視 以開啟選取的存放庫。