当前位置: 首页 > 知识库问答 >
问题:

带有必需路径参数的OpenAPI定义错误

阎啸
2023-03-14

我刚刚开始创建我的第一个OpenAPI定义(2.0版),我一直被这个错误所困扰:

无效的OpenAPI文件。请修复模式错误:\n\"/参数/分类Param\":域:验证;关键字:oneOf;消息:实例与一个模式不完全匹配;匹配:0"

它只是一个类似于“/cat/count”的查询,它将返回一个整数,即有多少猫-“cat”是所需的路径参数。我的参数定义到底有什么问题?

swagger: '2.0'
info:
  description: "xxx"
  title: "xxx"
  version: "1.0.0"
host: "xxx"
consumes:
- "application/json"
produces:
- "application/json"
schemes:
- "https"
parameters:
  categoryParam:
    in: path
    name: category
    required: true
    schema:
      type: string
    description: "xxx"
paths:
  "/{category}/count":
    get:
      operationId: "get_category_count"
      parameters:
        - $ref: "#/parameters/categoryParam"
      produces:
        - application/json
      responses:
        '200':
          description: "xxx"
          schema:
            $ref: '#/definitions/Model0'
definitions:
  Model0:
    properties:
      count:
        type: string

共有1个答案

史意致
2023-03-14

没关系,愚蠢的错误。我需要改变:

schema:
  type: string

只是:

type: string
 类似资料:
  • 我在Springdoc生成的OpenAPI规范中得到了验证错误,并且无法在网上找到与Java代码格式相匹配的示例。 我试图用Springdoc为Spring Boot控制器生成OpenAPI规范。我有一个具有多个路径变量的路径映射,方法签名接受一个命令对象(命令对象是由这些路径变量自动构造的)。swagger-ui.html似乎或多或少地起作用了,但是生成的JSON/YAML规范似乎并不有效。 为

  • 如何为这些参数编写OpenAPI(Swagger)定义?

  • 问题内容: 我在jsp页面中有一个img标签,其中src路径要求传递标头参数来获取图像。我们如何实现呢? 问题答案: 首先,您需要发出一个设置头文件的ajax请求。然后,您需要使用一些HTML5 API将接收到的二进制数据转换为base64。最后,使用协议和base64数据设置映像src 。 资料来源: https://developer.mozilla.org/zh- CN/docs/Web/A

  • 背景:我将Kotlin与Micronaut一起使用,对于这个项目,我不会添加Spring依赖项。 我成功地创建了一个Hello Word enpoint,我可以从邮递员那里发布到它。问题始于我将数据演化为生日(java.time.LocalDate)。 抄袭自邮递员 导致 实体 控制器 gradle.properties依赖关系 格雷德尔。属性 整个项目git hub(分支机构日期问题中的错误,而

  • 我有一个服务,它可以基于头有两种不同的主体参数。 例如。对于路径: > 如果使用 ,则 POST 可以将 作为正文参数。 如果使用了,那么POST应该使用一些不同的主体参数来调用函数并返回不同的响应。 关于如何在OpenAPI(Swagger)中体现这一点,有什么建议吗?

  • 有人能帮我解决我遇到的自定义Prestashop模块1.6版本的文件路径问题吗? 以下内容在本地主机环境中非常有效: 但是不能在实时服务器上工作。以下方法确实有效: 这是不可接受的,因为有些客户不会使用默认的引导主题。 对此问题的任何帮助都将不胜感激。 谢谢