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

Question

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

Answer 1

ошибка именно то, что говорится, «операция не может иметь несколько параметров тела». В вашем примере ошибка находится в операции POST /company/fastbill/customers.

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

 - 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'