使用 Swagger/OAS 测试 API

Question

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

Answer 1

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

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

最简单的运行方式:

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

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