Hi, I am currently setting up a new API using %CSP.REST - I've gotten swagger spec generation to work like such:

Class Api.DispatchRouter Extends %CSP.REST
{

XData UrlMap
{
<Routes>

<Map Prefix="/test" Forward="Api.Controllers.TestController"/>

<Route Url="/swagger" Method="GET" Call="SwaggerSpec"/>   
</Routes>
}

ClassMethod SwaggerSpec() As %Status
{
    Set tSC = ##class(%REST.API).GetWebRESTApplication($NAMESPACE, %request.Application, .swagger)
    Do swagger.info.%Remove("x-ISC_Namespace")
    Set swagger.basePath = "/csp/myapi"
    Set swagger.info.title = "My API"
    Set swagger.info.version = "0.0.0"
    Set swagger.host = "myhost.com"
    Return ..%WriteJSON($$$OK, swagger)
}

}

Class Api.Controllers.TestController Extends %CSP.REST
{

XData UrlMap
{
<Routes>

<Route Url="/:name" Method="GET" Call="Test"/>

</Routes>
}

/// This gets read by Swagger, can I add metadata here?
ClassMethod Test(name As %String) As %Status
{
    write "works!: " _ name, !
    Return $$$OK
}

}

This correctly reads all the endpoints inside the TestController based on the UrlMap, but it does not know the return type

I would like to be able to add additional info to each individual endpoint, for starters to manually define the possible return types/objects, as well as parameters from the %request, directly inside a comment above the ClassMethod.

I'd rather have it auto-generate the swaggerspec, so I'm wondering if anyone can point me in the right direction.

I have also heard of isc-rest package, but unless the features are outstanding, I'd prefer to stay away.