Swagger path ref remote URL of another Swagger document

[thisiskarthikj]

I am try to set a path's ref to another document in the remote server like as follows:

swagger: '2.0'
info:
  title: REST API specification
  description: >-
    test
host: 'localhost:3000'
basePath: /rest/abc/v4
schemes:
  - http
paths:
  /proxy2:
    $ref: "http://localhost:8080/api-docs/abc-rest-api-spec.yaml#/config"

Where abc-rest-api-spec.yaml is in another server. When I start the NodeJS server and access the swagger docs (with http://localhost:3000/api-docs), I do not see the API /proxy2 in swagger document.

The Spec documentation shows that using $ref for path is supported and it can point to absolute external URLs. Am I missing something ?

[cebe]

When I start the NodeJS server and access the swagger docs [...]

this is probably an issue that should be reported to the tool you are using, not to this repo (the spec itself).

[MikeRalphson]

As above, you may need to bundle or resolve the OpenAPI document into one file for this tool.

Thanks @cebe