json - 提供 YML 时使用 JSON 解析器的 swagger-codegen

标签 json yaml swagger-codegen

尝试使用 swagger-codegen 为 PHP 生成 API 类。

[根据文档][1],它应该自动知道 JSON 和 YML 之间的区别。

虽然看起来不是这样:

docker run --rm -v ${PWD}:/local swaggerapi/swagger-codegen-cli generate \
    -i https://.../interface.yml \
    -l php \
    -o /local/out/php

异常(exception):

[main] ERROR io.swagger.parser.SwaggerCompatConverter - failed to read resource listing
com.fasterxml.jackson.core.JsonParseException: Unrecognized token 'openapi': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false')
 at [Source: (String)"openapi: 3.0.1
info:
  title: Orders
  description: This API documentation describes all endpoints for orders
...

从 YML 生成客户端和实体的正确说明是什么?

最佳答案

您正在使用不支持 OpenAPI 3.0 的 Swagger Codegen 2.x

改用 codegen 版本 3.x:
https://hub.docker.com/r/swaggerapi/swagger-codegen-cli-v3/

关于json - 提供 YML 时使用 JSON 解析器的 swagger-codegen,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/59736500/

相关文章:

amazon-web-services - 使用 YAML 设置 S3 存储桶的问题

java - 您可以在 Spring 中完全禁用 CORS 支持吗?

android - Android中解析WordPress JSON API

javascript - 无法将从 Blender 导出的对象加载到 Three.js 中?

javascript - 使用 JavaScript 或 jQuery 将 json 的某些部分转换为数组

java - Java REST 客户端的 swagger-codegen header 参数

spring - 如何在 Swagger 中连接 importMappings 和 yaml

JavaScript JSON 组合和数据 Anylish

.net-core - 如何使用 YAMLDONET 和 C# 将 YAML 数据转换为 HTML 表?

java - 将 YAML 文件中的列表映射到对象列表