沒有有效的參數定義

Question

/cancel: 
    post: 
     description: '' 
     summary: Cancel 
     operationId: Cancel 
     produces: 
     - application/json 
     parameters: 
     - name: Body 
     in: body 
     required: true 
     description: '' 
     schema: 
      $ref: '#/definitions/CancelRequest' 
     - name: Authorization 
     in: header 
     required: true 
     description: '' 
     schema: 
      $ref: '#/definitions/Authorization' 
     - name: Content-Type 
     in: header 
     required: true 
     type: string 
     description: '' 

這是摘錄。它說在$ref: '#/definitions/CancelRequest'的行上有一個錯誤的參數定義。可能是什麼問題？

Answer 1

的誤差可能是誤導性的，問題是與其它參數：

/cancel: 
    post: 
     consumes: 
     - application/json 
     - application/xml 

部首參數要求：

1. 的Content-Type頭應該用consumes關鍵字，而不是一個參數來定義一個type（而不是schema）和type必須是一個簡單的類型，不能是$ref。因此，它應該是：

   - name: Authorization 
        in: header 
        required: true 
        description: '' 
        type: string # <------- 
   

   然而，在Authorization頭的情況下，你應該使用一個security definition來代替。例如，如果您的API使用基本認證：

   securityDefinitions: 
       BasicAuth: 
       type: basic 
   
   paths: 
       /cancel: 
       post: 
        security: 
        - BasicAuth: []