如何从API的JSON响应体自动生成OPEN API YAML文件？

下面这些工具能直接从JSON响应体自动生成OpenAPI规范，适配你有大量字段的场景：

• JSON Schema生成+OpenAPI转换组合
  先把JSON响应体转成JSON Schema，再导入到Swagger Editor的「Import」功能，它会自动将Schema映射到OpenAPI的components/schemas结构中，不用手动逐个编辑字段。你可以用本地开源的JSON Schema生成工具离线处理，避免依赖在线服务。

• openapi-generator-cli
  这是官方命令行工具，支持从JSON响应直接生成OpenAPI文件。把JSON响应保存为本地文件后，执行类似命令即可：

  openapi-generator-cli generate -i your-response.json -g openapi-yaml -o output-folder
  

  它会自动推断字段类型、嵌套结构，300+字段的场景也能高效处理，生成的Schema结构规范。

• Stoplight Studio
  支持直接导入JSON响应体，自动解析并生成对应的OpenAPI Schema。可视化界面能快速调整自动生成的内容，比纯手动编辑效率高很多，适合批量处理多个API。

• Postman进阶用法
  你之前觉得Postman示例质量差，其实可以在发送请求后，在响应面板选择「Generate Schema」，基于实际响应生成JSON Schema，再把这个Schema复制到OpenAPI文件的responses对应的content/application/json/schema节点下，比直接用示例文档更精准。

内容的提问来源于stack exchange，提问作者Adrien Maillard