# 将 API 版本推送到 GitHub

将您的 API 关联到 GitHub 储存库，并以 OAS/Swagger 或 RAML 格式推送您的 API 定义。

* 您拥有一个 GitHub 帐户和一个储存库。
* GitHub 支持您的浏览器（由于 GitHub 不再支持 Internet Explorer 11，因此 IE11 的 API Contracts 不支持此功能）。

1. 如果您的 GitHub 账户尚未关联到您的 API Contracts 账户，请前往 API Contracts 设置。
2. 点击关联您的 GitHub 账户。

   ![API Contracts 设置中的 GitHub 账户部分。](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/link-your-github-account.png)
3. 在打开的窗口中，登录 GitHub 并单击授权 Talend，以允许 API Contracts 访问您的 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-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/push_to_github_01_link.png)
7. 保存设置后，点击 推送。

   当您的项目包含尚未推送到 GitHub 的更改时，推送 右侧会显示一个绿点。![项目包含尚未推送到 GitHub 的更改时的屏幕截图。](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/push_to_github_03_push.png)
8. 输入提交信息和标签（如有需要），然后点击 推送。

   标签应当唯一，并且应当关注这些规则：
   * 它只能包含字母数字字符和以下特殊字符：\_、-、. 和 /。
   * 不能以特殊字符开头或结尾。
   * 不能包含以下字符模式： ..、// 和 /.。

所选版本的 API 定义已推送到您的储存库。生成的文件名包含 API 名称和版本。

您可以点击 在 GitHub 上查看 以打开所选储存库。