Swagger 招摇过市:不允许在POST方法上查询参数?

Swagger 招摇过市:不允许在POST方法上查询参数?,swagger,3scale,Swagger,3scale,我在Swagger中描述了一个POST端点,我希望该端点也有查询参数。我们使用1.2的招摇过市格式是因为,好吧,传统的原因。我们使用3scale,它承载文档,您可以在其web UI中编辑您的炫耀。但是,当我试图保存文档时,它会给我以下错误 JSON规范不能在同一方法上使用paramType='body'和paramType='query' 我在招摇过市的说明书中找不到任何说明这是实际限制的东西。这可能是3Scale特有的,还是一个普遍的招摇限制?如果是后者,有人能告诉我一个规范吗 实际的REST

我在Swagger中描述了一个POST端点,我希望该端点也有查询参数。我们使用1.2的招摇过市格式是因为,好吧,传统的原因。我们使用3scale,它承载文档,您可以在其web UI中编辑您的炫耀。但是,当我试图保存文档时,它会给我以下错误

JSON规范不能在同一方法上使用paramType='body'和paramType='query'

我在招摇过市的说明书中找不到任何说明这是实际限制的东西。这可能是3Scale特有的,还是一个普遍的招摇限制?如果是后者,有人能告诉我一个规范吗

实际的REST端点并不关心,它对帖子上的查询参数很满意。这只是为了让招摇过市的工具变得快乐。以下是《大摇大摆》的简短片段:

{
  "parameters": [
    {
      "name": "myQueryParam",
      "dataType": "string",
      "paramType": "query",
      "required": true
    },
    {
      "name": "body",
      "dataType": "string",
      "paramType": "body",
      "required": true
    }
  ],
  "httpMethod": "POST"
}

不确定错误消息是否为一般验证错误,但在您共享的规范中有几个错误:

  • 它是“方法”,而不是“httpMethod”
  • 它是“类型”而不是“数据类型”

据我所知,这只是一个自大规格方面的限制。它们还限制在GET方法中传递请求体。我不认为有这样的限制有什么意义,因为用例各不相同,而且可能不足以将所需的参数作为查询参数发送,特别是由于它的大小限制。