使用Swagger / OAS测试API

Question

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

Answer 1

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

swagger-cli validate Test.yaml

Answer 2

您的架构和其中定义的示例可用于通过Schemathesis之类的工具来生成和执行测试用例。

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

最简单的运行方式：

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

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