Spec Path & BasePath

[swagger-api]

Spec Path & BasePath

[fehguy]

The "correct" way to map your resources to a subpath has been documented here:

https://github.com/wordnik/swagger-node-express#mapping-swagger-to-subpaths

That allows you to code the methods independently of the actual basePath, which makes the entire system easier to move around.

Does that answer your question?

[mangvlad]

When I try to follow instruction referenced above, I am unable to get the UI working.
I am getting the v1/api-docs.json but references to individual apis are not correct (swagger UI returning 404 errors):

{
"apiVersion": "0.1",
"swaggerVersion": "1.1",
"basePath": "http://localhost:8002",
"apis": [
{
"path": "/api-docs.{format}/security",
"description": "none"
},
{
"path": "/api-docs.{format}/regions",
"description": "none"
},
{
"path": "/api-docs.{format}/campuses",
"description": "none"
},
{
"path": "/api-docs.{format}/countries",
"description": "none"
},
{
"path": "/api-docs.{format}/files",
"description": "none"
}
]
}
Any other way to get the subpath working?

[fehguy]

please take a look at the 1.2 spec, which has made this a lot easier. code is in master to support this.