使用 Swagger/OAS 测试 API答案

【问题标题】：Testing API with Swagger/OAS使用 Swagger/OAS 测试 API
【发布时间】：2018-09-27 08:44:45
【问题描述】：

我花了一些时间用 Swagger/OAS 3 记录 API。我想验证我们当前的 API 是否符合 OAS 3 文档。我该怎么做？

【问题讨论】：

【解决方案1】：

您的架构和其中定义的示例可用于使用Schemathesis 等工具生成和执行测试用例。

它同时使用示例和模式，默认情况下不需要配置。它利用基于属性的测试来生成数据并验证在测试模式中定义的属性——响应代码、模式和标头。它还将任何 5xx 响应视为错误并进行报告。

最简单的运行方式：

schemathesis run -c all http://my.server.com/openapi.json

此命令将读取架构、生成测试、针对该服务器执行测试、运行所有内置检查并报告所有发现的问题。

【讨论】：

【解决方案2】：

您可以使用swagger-cli 来验证您的规范。

swagger-cli validate Test.yaml

【讨论】：