如何从示例JSON生成Swagger #definition

Question

从宠物商店示例中获取以下#definition。给定#definition部分可以生成JSON结构

e.g。

在给定大量复杂的JSON文件的情况下，有什么东西可以反过来吗？

鉴于以下JSON结构，我可以获取生成的swagger文件的#defintion部分以节省一些输入

{
  "variable": "sample",
  "object1": {
    "obj-field1": "field 1 of object",
    "obj-field2": "field 2 of object",
    "anArray": [
      "Value 1",
      {
        "anArrayObj1": "obj1fieldinarray",
        "anArrayObj2": "obj2fieldinarray"
      }
    ]
  }
}

Answer 1

1-将响应粘贴到http://www.mocky.io中，并获得指向您响应的链接

2-转到https://inspector.swagger.io/并致电您的示例回复

3-从“历史记录”中选择调用，然后单击“创建API定义”

4-可以在https://app.swaggerhub.com/

中使用招摇定义

Answer 2

您可以使用此JSON-to-OpenAPI架构转换器：
https://roger13.github.io/SwagDefGen/

（GitHub project）

我个人虽然没有使用它，所以我不确定它有多好。

由于OpenAPI使用JSON Schema的子集，您也可以使用JSON Schema generators之一，但是您可能需要手动调整生成的定义以使其与OpenAPI兼容。

Answer 3

这对我有用：

从示例JSON生成Swagger REST客户端代码（和POJO）：

1. 转到 apistudio.io ：

   • 插入->新模型。
   • 剪切粘贴您的JSON。
   • [将生成Swagger YML文件]
   • 下载-> YAML。

2. 转到 editor.swagger.io ：

   • 剪切粘贴上一步中保存的YML。
   • Generate Client-> jaxrs-cxf-client（还有许多其他选项）。