json - 如何在单个 API 调用中以 swagger 定义查询和正文参数

Question

API 在正文和查询中有参数，我需要在 swagger 中定义它，如下所示:

parameters: [
  {
    "name": "businessCode",
    "in": "query",
    "required": true,
    "type": "string",
  },
  {
    "name":"clientCode",
    "in":"query",
    "required":true,
    "type":"string",
  },
  {
    "name":"client",
    "in":"body",
    "required":true,
  }
]

Answer 1

我认为这很简单，您已经给出了一个例子。这是另一个正确的例子。

parameters: [{
      name: "id",
      description: "id of something",
      required: true,
      type: "Id",
      paramType: "query"
    },
    {
      name: "Body",
      description: "any data",
      required: true,
      type: "User", //define this model in model file
      paramType: "body"
    }]