Swagger: параметры запроса для методов POST не разрешены?

Question

У меня есть конечная точка POST, описанная в Swagger, и я хочу, чтобы эта конечная точка также имела параметры запроса. Мы используем формат Swagger 1.2, потому что, ну, унаследованные причины. Мы используем 3scale, он размещает документы, и вы редактируете свою чванство в их веб-интерфейсе. Однако, когда я пытаюсь сохранить документ, он выдает следующую ошибку:

JSON Spec can not have paramType='body' and paramType='query' on the same method

Я не могу найти ничего в спецификациях сваггера, которые говорят, что это фактическое ограничение. Вероятно, это что-то особенное для 3Scale или это общее ограничение чванства? И если последнее, кто-то может указать мне на спецификацию, которая разъясняет это?

Фактическая конечная точка REST не заботится, она довольна параметрами запроса на POST. Это просто инструмент Swagger, чтобы быть счастливым. Вот сокращенный фрагмент документа о чванстве:

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