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

Swagger为主体参数抛出“Swagger Error不是有效的参数定义”

贺文彬
2023-03-14

这是我的输入:

  parameters:
    - name: body
      in:  body
      required: true
      type: object
      description: | 
        The body.
      schema:
        $ref: '#/definitions/CsrRequest'

它说:

详细资料

 Object
code:  "ONE_OF_MISSING"
message:  "Not a valid parameter definition"
 path: Array [5]
 inner: Array [2]
level: 900
type:  "Swagger Error"
description:  "Not a valid parameter definition"
lineNumber: 24

我到底做错了什么?

共有1个答案

杨晓博
2023-03-14

您需要根据此问题从正文中删除类型:对象

parameters:
  - name: body
    in:  body
    required: true
    description: | 
      The body.
    schema:
      $ref: '#/definitions/CsrRequest'
 类似资料:
  • Swagger没有为这个查询参数提供有效的参数定义。如果我删除路径和参数定义中对用户名的所有引用,则不会出现任何问题。 根据Swagger规范,我相信我使用了正确的查询参数,但不知何故它不是。

  • 我正在尝试为rest api定义一个简单的swagger定义。我在所有参数部分都收到错误。 我在招摇编辑器中得到了以下招摇定义错误,我不知道我错了什么。请告知。 昂首阔步的定义: 昂首阔步错误:

  • 我面临的问题与我的招摇文件: 这是我的问题: ✖Swagger Error非有效参数定义跳转到第20行详细信息目标代码:ONE_OF_MISSING参数:数组[0]消息:非有效参数定义路径:数组[5] 0:路径1:/货币/{当前ID} 2:获取3:参数4:0模式ID:http://swagger.io/v2/schema.json#内部:数组[2]级别:900类型:Swagger Error描述:

  • 我有这个夸张的定义 但它给我以下错误 ✖ Swagger Error Not a valid parameter definition跳转到第6996行Details Object code:“ONE\u OF_MISSING”参数:数组[0]消息:“Not a valid parameter definition”路径:数组[5]schemaId:http://swagger.io/v2/sch

  • 我想发布一个字符串数组,如 到基于 Swagger 的 API。在我的大摇大摆的文件中,我有这些行: 将< code > id 的类型指定为字符串数组的正确方法是什么? 更新: 根据规范,以下应该在我的选项中工作: https://github.com/Yelp/swagger_spec_validator不接受它,并返回一长串错综复杂的错误,这些错误看起来像代码需要一些。

  • 我在swagger 2.0文件中定义了两个可重用参数: 然后在我的路由定义中(在本例中为GET),我尝试这样引用这两个: 如果我使用一个$ref,它似乎工作正常(没有编译错误),但是如果我尝试两个都使用,它会看着我: 此外,如果我在查询字符串中传递这些参数并输出<code>req.swagger。params</code>,我得到一个空对象。我做错了什么? 这是规范的完整SSCCE,生成相同的错误