如何根据 Postman 中的 API 规范自动刷新文档

How to auto refresh documentation based on an API specification in Postman

我正在尝试在 Postman 中为我的 API 规范设置文档。我现在的问题是,如果我在打开 API 屏幕上修改某些内容,我的文档不会更新。

现在更新它的唯一方法是删除它并重新创建它。知道如何在不这样做的情况下自动刷新它吗? (如果可能的话)

我添加了这张截图来帮助理解我到底在用什么:

您不必每次都删除集合,您可以通过 UI:

更新以前生成的 API 元素(例如文档、测试等)
  • 打开“文档”选项卡
  • 单击右上角的根据定义验证
  • 单击找到的问题并访问问题摘要
  • Select 更改并应用

相关文档可在此处找到:https://learning.postman.com/docs/designing-and-developing-your-api/validating-elements-against-schema/#updating-api-elements

这是一个向您展示如何操作的视频:https://youtu.be/BUZiRtGRHj0?t=340

目前无法在架构更改时自动触发更新,但您可以使用 Postman API 通过 Sync relation with schema 端点定期提取更改: https://www.postman.com/postman/workspace/postman-public-workspace/documentation/12959542-c8142d51-e97c-46b6-bd77-52bb66712c9a