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

Swager Editor显示路径参数的“Schema error:should NOT have additional properties”错误

杨晓博
2023-03-14

我正在使用http://editor.swagger.io为了设计API,我遇到了一个我不知道如何解决的错误:

Schema error at paths['/employees/{employeeId}/roles'].get.parameters[0]
should NOT have additional properties
additionalProperty: type, format, name, in, description
Jump to line 24

我以类似的方式定义了其他终结点,并且没有收到此错误。我想知道我是否对缩进或未闭合的引号有一些问题,但情况似乎并非如此。谷歌似乎也没有提供任何有用的结果。

swagger: "2.0"
info:
  description: Initial draft of the API specification
  version: '1.0'
  title: App 4.0 API
host: api.com
basePath: /v1
tags:
  - name: employees
    description: Employee management
schemes:
  - https
paths:
  /employees/{employeeId}/roles:
    get:
      tags:
        - employees
      summary: "Get a specific employee's roles"
      description: ''
      operationId: findEmployeeRoles
      produces:
        - application/json
      parameters:
        - name: employeeId   <====== Line 24
          in: path
          description: Id of employee whose roles we are fetching
          type: integer
          format: int64
      responses:
        '200':
          description: successful operation
          schema:
            type: array
            items:
              $ref: '#/definitions/Role'
        '403':
          description: No permission to see employee roles
        '404':
          description: EmployeeId not found

有什么提示吗?

共有3个答案

冀阳文
2023-03-14

对我来说,错误的原因是路径中缺少前导斜杠(internal/resource而不是/internal/resource)。

是的,错误消息是极其无用的。

齐英朗
2023-03-14

也有同样的问题。我不小心混淆了< code>Swagger 2.0和< code>Openapi 3.0.x的语法。在< code>Openapi 3.0.x中,定义被重新定义为组件。在在线编辑器中,您可以点击编辑按钮

在此处阅读有关组件的更多信息。

备注:

OAS 3 是 OpenAPI 规范的最新版本。

宫俊远
2023-03-14

错误消息具有误导性。实际错误是路径参数缺少required:true。路径参数始终是必需的,因此请记住将required:true添加到它们中。

 类似资料:
  • 运行下面的代码段,将至少两个项目拖到中心,按“创建”按钮并尝试连接endpoint以查看问题。 当我尝试连接来自不同div的endpoint时,它们实际上是连接的,但问题是,连接路径显示错误。它始终连接源endpoint所在的同一个div中的endpoint。尽管如此,如果您将鼠标悬停在我真正想要连接的点上,这表明连接已经完成,甚至拖动也可以工作。亲自尝试一下,获得完整的体验。

  • 输入出发地和抵达地,可搜索前往目的地的路径。 轻触(选项)>[搜索路径],在出发地与抵达地的字段各自输入关键词并轻触[搜索]。地图会显示最短路径。 可从书签中选择出发地及抵达地。请轻触(书签),选择地点。 A ) (徒步)/(乘车) 可选择路径的移动方式。轻触即会以选择的移动方式搜索最短路径。 B ) 与目的地间的距离及所需时间 C ) (显示列表)/(隐藏列表) 轻触即可将搜索结果列表切换为显示

  • 我正在创建一个OpenAPI(Swagger)定义并在http://editor.swagger.io.中检查其有效性出于某种原因,Swagger Editor显示了此错误: 下面是我的YAML文件: 我没有像错误消息所暗示的那样添加任何其他属性。如何修复此错误?

  • 我已成功将图像上载到我的上载目录。这就是结构 公共网页- 现在,我在DB记录中存储的路径是: ./上传/上传图片。gif 但当我这么做的时候: 它仍然没有显示任何东西。图像路径内容为/上传/上传图片。gif。 我正在尝试将图像加载到位于以下位置的视图中: 公共网页- 我会非常感激你的帮助。

  • 我刚刚开始创建我的第一个OpenAPI定义(2.0版),我一直被这个错误所困扰: 无效的OpenAPI文件。请修复模式错误:\n\"/参数/分类Param\":域:验证;关键字:oneOf;消息:实例与一个模式不完全匹配;匹配:0" 它只是一个类似于“/cat/count”的查询,它将返回一个整数,即有多少猫-“cat”是所需的路径参数。我的参数定义到底有什么问题?

  • 问题内容: 你如何grep只返回匹配的行?即结果中省略了路径/文件名。 在这种情况下,我想查看当前目录中的所有.bar文件,并搜索FOO。 问题答案: 没必要。如果您只是在特定目录中寻找模式,就足够了: 隐藏文件名的参数在哪里,例如: -h,–no-文件名 在输出中禁止文件名的前缀。当仅搜索一个文件(或仅标准输入)时,这是默认设置。 请注意,您使用的是 -H,–with-filename 打印每个