使用Swagger 2.0创建REST API文档时出现此错误

Question

为什么我在Swagger Editor中获取“操作不能有多个主体参数”错误？

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'