使用 Git 管理 Postman API 更改
使用 Git 管理 Postman API 更改
在Postman中使用Git管理API更改，可以帮助团队成员更好地协作和版本控制。本文将详细介绍如何在Postman中进行分支管理、提交和推送更改、拉取更改以及解决冲突等操作。
连接到远程Git存储库后，你可以使用Postman更改API并与其他团队成员协作。你对API的定义或集合所做的任何更改总是发生在分支上。你可以在存储库中的任何分支上工作。
如果你配置了远程存储库，Postman会将你的更改存储在本地缓存中。当你准备好与他人共享你的工作时，将你的更改推送到远程存储库。
使用分支机构
Git分支可帮助你组织工作并与他人协作。作为API生产者，你总是在一个分支上工作。
切换分支
如果你的Git存储库有多个分支（例如main、develop和功能分支），你可以在Postman中的分支之间切换。切换到分支使其成为活动分支。
要切换分支，请选择Postman页脚中的Git分支下拉菜单，然后选择要激活的分支。切换到分支后，你可以使用Postman更改API的定义和集合。你所做的任何更改都存储在活动分支中。
Postman在列表中显示一组有限的分支。如果未列出分支，请在下拉列表的“搜索”框中输入分支名称，然后选择要切换到的分支。
创建一个新分支
功能分支使你能够在不影响存储库中的默认分支的情况下对API进行更改。当你创建一个新分支时，Postman会自动将其设为活动分支。
要在远程存储库中创建一个新分支，请执行以下操作：
- 在边栏中选择API，然后选择一个API。
- 在Postman页脚中选择Git分支下拉菜单。
- 在搜索框中输入新分支的名称。
- 选择从当前分支创建分支。Postman根据当前活动分支创建新分支。
推动和拉动变化
在你处理API时，Postman会跟踪你对活动分支所做的更改。使用“源代码管理”窗格查看和管理你的更改历史记录。你可以将你的更改提交并推送到远程存储库，以使你的工作对其他人可用。你还可以提取更改以使你的工作文件与远程存储库保持同步。
要显示或隐藏提交历史记录，请选择Commits。展开提交以查看有关更改的详细信息。如果有多个更改的文件，你可以使用Commits旁边的下拉菜单来显示文件历史记录或显示所有提交。
提交和推送更改
SourceControl窗格显示Postman中活动分支的更改数量。
要提交更改并将更改推送到远程存储库，请执行以下操作：
- 在边栏中选择API，然后选择一个API。
- 在右侧边栏中选择源代码管理图标 。
- 如果你想在提交和推送更改之前查看更改，请将鼠标悬停在文件上并选择差异图标 。
你可以通过选择旁边的丢弃图标来丢弃文件中的更改 。 - 要将保存的更改提交到活动分支，请输入提交消息并选择Commit and Push。
如果远程仓库有变化，需要先拉取变化，然后才能提交和推送。
在你推送更改后，你团队中的其他生产者可以切换到分支、拉取更改并查看你所做的更新。
拉动变化
拉动将更改从远程（原始）分支带到你的活动分支。
要从远程分支中提取更改，请执行以下操作：
- 在边栏中选择API，然后选择一个API。
- 在右侧边栏中选择源代码管理图标 。拉动图标 表示你的活动分支在远程分支后面的提交数。
- 选择拉动图标将更改引入你的活动分支。
如果有任何冲突，你需要先解决冲突，然后才能完成拉取更改。
解决冲突
如果活动分支中的更改与远程（原始）分支中的更改冲突，则必须先解决冲突，然后才能拉取更改。
要解决冲突，请执行以下操作：
- 在每个受影响的文件旁边，选择保留远程文件或保留本地文件。
- 完成后，选择Pull Changes。
如果有冲突的文件不是Postman support的格式，你需要在首选的Git客户端中解决冲突。
创建拉取请求
将更改推送到分支后，你可以创建拉取请求(PR)以将你的更改合并到另一个分支。例如，如果你正在处理功能分支，则可以创建拉取请求以将你的更改合并到存储库的主分支中。
要创建拉取请求，请执行以下操作：
- 在边栏中选择API，然后选择一个API。
- 在右侧边栏中选择源代码管理图标 。
- 选择创建PR。将打开一个浏览器选项卡，你可以在其中完成创建PR。
合并PR后，请确保切换到你合并更改的分支并拉取更改。
使你的更改对其他人可用
你推送到远程存储库的任何分支和更改对你团队中的其他API生产者都是可见的。你还可以创建拉取请求以请求团队中的其他人审查你的更改。
要使你的API使用者可以使用你的更改，请发布新版本的API。当你发布一个版本时，API的定义和集合会同步到你在Postman云中的工作空间。消费者可以在你的工作空间中查看版本。你还可以选择将版本添加到你的私有API网络。了解有关发布API版本的更多信息。