Forum Discussion

Neterium's avatar
Neterium
New Contributor
7 years ago

(OpenAPI v3) Can't add an external JSON example

Hi,   I'm trying to add an example in my OpenAPI spec. I checked the specification and docs, it should look like this if I'm right: (I've hidden the IP intentionally)   The spec sample:   cont...
HKosova's avatar
HKosova
SmartBear Alumni (Retired)
7 years ago

A couple of notes in addition to what Ron said:

 

1)

      $ref: "#components/schemas/object"

should be

      $ref: "#/components/schemas/object"

with a / after #.

 

2)

    schema:
      $ref: 'http://xxx.xxx.xxx.xxx/schemas/1.0/screen.request.json'

You probably know this, but just in case - the schema in screen.request.json is supposed to be an OpenAPI Schema object and not a JSON Schema. E.g. this schema should not have the $schema, $id and other JSON Schema properties not supported by OpenAPI.