OpenAPI：如何验证示例？

Question

当您呈现文档时，RAML 会使用相应的模式自动验证包含的示例。

有没有办法对 OpenAPI 3 规范做同样的事情？

codekie/swagger-examples-validator目前仅支持 OpenAPI 2。

任何人都知道一个简单的解决方案来根据他们的模式检查所有示例？

Answer 1

官方 OpenAPI 工具不会验证引用的示例，特别是因为官方规范甚至不要求示例与架构匹配（请参阅：OpenAPI 规范），它仅声明它“应该”匹配：

媒体类型的示例。每个示例对象应该匹配媒体类型和指定的模式（如果存在）。

您将不得不依赖第三方工具。

一种选择是codekie/openapi-examples-validator，它现在支持 OpenAPI 3 规范