Swagger模拟服务器

Question

我在Swagger文件中有一个API参考.我想创建一个非常简单的模拟服务器,以便在我调用时:

mymockurl.com/users 它将返回一个预定义的json(无需连接到数据库).

最简单的方法是什么？我不是后躯.

Answer 1

从没有代码的OpenAPI(fka.Swagger)规范创建简单模拟的简单方法是使用http://github.com/stoplightio/prism上提供的工具调用棱镜

这个命令行就是您所需要的:

./prism run --mock --list --spec <your swagger spec file>

模拟服务器将根据OpenAPI规范返回动态响应.如果规范中提供了示例,prism将返回它们,否则它将根据规范生成虚拟数据.

Answer 2

SwaggerHub为OpenAPI 2.0和3.0规范提供了一个模拟服务器.免费和付费计划都支持模拟.

要使用模拟服务器,请将您的规范导入SwaggerHub并启用"API Auto Mocking".模拟响应可以是JSON,YAML和XML,并根据您的响应模式和产生example,default并且enum在架构中定义的值.

披露:我为制作SwaggerHub的公司工作.

Answer 3

根据OpenAPI/Swagger规范,您可以使用Swagger Codegen在不同的服务器框架中生成服务器存根(例如Java Spring.PHP Slim,Ruby on Rails5等).

以下是相关文档:

https://github.com/swagger-api/swagger-codegen/wiki/Server-stub-generator-HOWTO

更新:2018年5月,Swagger Codegen的大约50名顶级贡献者决定分配项目以创建一个名为OpenAPI Generator的社区驱动版本.有关fork的原因,请参阅问答.

Answer 4

Imposter是一个可编写脚本的多用途模拟服务器.

在Docker环境中设置非常简单,并提供了一个Swagger UI来与你的模拟api一起玩.

我们来看一个示例设置

1. 在文件夹中的文件中准备好swagger配置 config/petstore.yaml

   swagger: "2.0"
   info:
   version: 1.0.0
   title: Swagger Petstore
       .
       .
       .
   

   您可以从此处复制示例swagger规范.

2. 创建一个配置文件骗子在config/openapi-plugin-petstore-config.json

   {
     "plugin": "com.gatehill.imposter.plugin.openapi.OpenApiPluginImpl",
     "specFile": "petstore.yaml"
   }
   

   配置文件的名称必须以-config.json.

3. 用Docker运行Imposter

   确保您的shell放在config并运行的父目录中

   docker run -ti -p 8443:8443 \
   -v $(pwd)/config:/opt/imposter/config \
   outofcoffee/imposter-openapi
   

4. 打开http:// localhost:8443/_spec /以使用您的Mock Server和Swagger UI

   

Answer 5

这是来自 swagger yaml 的模拟 api 服务器的docker 容器。

docker run -i \
    -p 8000:8000 \
    -v /path/to/file.yaml:/data/swagger.yaml \
    -t palo/swagger-api-mock:latest

这是内部使用swagger-mock-api

Answer 6

模拟服务器项目支持基于 Swagger/OpenAPI 规范创建存根。

https://www.mock-server.com/mock_server/using_openapi.html