我如何在 SwaggerHub 中引用不同的 API？

Question

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

第一个获得了以下访问权限link： 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'

但出现以下错误：

"Could not resolve reference because of: Could not resolve pointer: /components/schemas/ApiOffer does not exist in document"

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

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

Answer 1

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

我如何在 SwaggerHub 中引用不同的 API？

How do I refer between different APIs in SwaggerHub?

swagger

openapi

swaggerhub