將 Swagger 2.0 文件轉換為 OpenAPI 3.0 時出現“結構錯誤”

Question

我的代碼片段：

  insuranceCompanyNbr:
    type: integer
    totalDigits: 6
  invoiceTypeInfo:
    $ref: '#/definitions/invoiceTypeInfo'
  submitterTypeId:
    type: string

我收到此錯誤：

錯誤：definitions.InvoiceType.properties.insuranceCompanyNbr 處的結構錯誤。
不應該有額外的屬性。
附加屬性：totalDigits

我該如何解決這個錯誤？

我嘗試在代碼的開頭添加模式，但沒有用。

Answer 1

OpenAPI 中沒有totalDigits關鍵字——v. 2.0 和 3.x 中都沒有。 您需要刪除此關鍵字，或在其前面加上x-以使其成為擴展名（即任意元數據）。