Как мне ссылаться между различными API в SwaggerHub? - PullRequest
Новая
       20

Как мне ссылаться между различными API в SwaggerHub?

0 голосов
/ 12 ноября 2018

Я работаю с SwaggerHub и OpenAPI 3.0.0. У меня есть два API в SwaggerHub.

Первый получил следующую ссылку доступа: 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?

1 Ответ

0 голосов
/ 12 ноября 2018

Ссылки на определения SwaggerHub должны использовать имя хоста API.swaggerhub.com вместо APP.swaggerhub.com.

...