При создании документации REST API с использованием Swagger 2.0 получаю эту ошибку

Question

Почему я получаю сообщение об ошибке "Операция не может иметь несколько параметров тела" в редакторе Swagger?

Answer 1

Ошибка именно то, что она заявляет, "операция не может иметь несколько параметров тела". В вашем примере ошибка в POST /company/fastbill/customers операция.

body Параметр представляет тело запроса. Поэтому, если вы хотите разместить несколько объектов данных, вам нужно объединить их в один объект. Например:

        - name: body
          in: body
          required: true
          schema:
            type: object
            properties:
              customer_details:
                $ref: '#/definitions/Customer'
              bank_account:
                type: object
                properties:
                  sources:
                    type: array
                    items:
                      $ref: '#/definitions/BankAccount'