Forum Discussion

TimBouffard's avatar
TimBouffard
New Contributor
6 years ago

Referencing Domain document from OpenAPI 3.0 document

Hi - I have a domain document at  https://app.swaggerhub.com/domains/UPennISC/pennant_domain/1.0.0 With a 'definitions:' section and a 'commonResponesStatusStructure' structure.   I'm trying ...
Nastya_Khovrina's avatar
Nastya_Khovrina
SmartBear Alumni (Retired)
6 years ago

Hi Tim,

 

You can refer to a domain structure  using the following syntax:

$ref: 'https://api.swaggerhub.com/domains/{ownerId}/{domainName}/{domainVersion}#/{componentType}/{componentName}'

Please see this documentation for details: https://app.swaggerhub.com/help/domains/referencing-domain

 

so, in your case, you should use   'https://api.swaggerhub.com/domains/UPennISC/pennant_domain/1.0.0#/definitions/commonResponesStatusSt...'

instead of

  'https://app.swaggerhub.com/domains/UPennISC/pennant_domain/1.0.0#/definitions/commonResponesStatusSt...'

 

  • TimBouffard's avatar
    TimBouffard
    New Contributor
    6 years ago

    Ah - thank you.  I feel really stupid for missing that!