Question

我正在使用SwaggerHub和OpenAPI 3.0.0。我在SwaggerHub中有两个API。

第一个具有以下访问链接： https://app.swaggerhub.com/apis/myapipath/1.0.0并包含名为components/schemas/ApiOffer的定义。

在第二个API中，我希望属性offer是该定义的$ref。我使用：

components:
  schemas:
    Offerers:
      type: object
      required:
        - offererId
        - overview
      properties:
        offererId:
          $ref: '#/components/schemas/OfferersId'
        overview:
          $ref: '#/components/schemas/OfferersOverview'
        offer:
          $ref: 'https://app.swaggerhub.com/apis/myapipath/1.0.0#/components/schemas/ApiOffer'

但出现以下错误：

”由于以下原因而无法解析引用：无法解析指针： / components / schemas / ApiOffer在文档中不存在

即使存在/components/schemas/ApiOffer定义。

如何更正我的引用，使其指向另一个API？

Answer 1

对SwaggerHub定义的引用必须使用主机名API.swaggerhub.com而不是APP.swaggerhub.com。

如何在SwaggerHub中的不同API之间进行引用？

1 个答案: