Forum Discussion

TimBouffard's avatar
TimBouffard
New Contributor
6 years ago
Solved

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 to reference it in my OpenAPI 3.0 document like this:

responses:
   '200':
     description: Response from the web service.
     content:
         application/json:
           schema:
             $ref:                    'https://app.swaggerhub.com/domains/UPennISC/pennant_domain/1.0.0#/definitions/commonResponesStatusStructure'

 

I get "Could not resolve reference: Could not resolve pointer: /definitions/commonResponesStatusStructure does not exist in document"

What am I doing wrong? This works fine for me in a 2.0 api document but I'm not sure how to make it work in 3.0.  I was told this should work.  Feel like I'm just missing one thing. I've tried to google my way to a solution and I can't find one.  Thanks - Tim

 

Here's a paste of the domain document (indenting was lost when pasted.)The domain document is valid.

 


info:
description: Reusuable pieces for other Pennant Web Services.
version: "1.0.0"
title: Pennant Domain

definitions:

# fields

# general return values, typcially included in responses
returnCode:
type: integer
format: int32
title: returnCode
description: Return information regarding web service call. 0 = Success, <> 0= Specific error code.
returnMessage:
type: string
title: returnMessage
description: Return message text.


# structures
commonResponesStatusStructure:
title: commonResponesStatusStructure
description: Common response 'status' structure.
required:
- returnCode
properties:
returnCode:
$ref: '#/definitions/returnCode'
returnMessage:
$ref: '#/definitions/returnMessage'

2 Replies