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