Postman 架构导入验证错误

Question

我正在尝试导入我们的 API 生成的 OpenAPI json 文件以在 Postman 中使用它。在导入过程中，邮递员显示了很多验证错误，导致我无法使用它。

https://i.sstatic.net/rv5olpkZ.png

我可以在配置中添加任何内容来防止这种情况吗？

Answer 1

如果 Postman 难以使用 OpenAPI，我会首先检查 OpenAPI 文件本身是否有效。此处可以使用任何 OpenAPI linter 工具，但大多数工具都有默认规则集，可能对您的需求来说过于严格。

这是仅使用 Redocly CLI 进行非常基本的有效性检查的示例（免责声明：我为 Redocly 工作，因此这不是一个独立的工具推荐）：

1. 安装Redocly CLI

2. 像这样检查它（假设你的文件名为

   openapi.yaml

   ）：

redocly lint --extends minimal openapi.yaml

如果您看到错误，请尝试修复它们，然后再尝试使用 Postman 或其他工具使用该文件（您可能还会看到一些警告，但我的建议是从修复错误开始）。