Trouble integrating cbSwagger in a modular ColdBox project

Communities
1

Hello everyone,

I’m currently facing issues integrating cbSwagger into my modular ColdBox application. I installed cbSwagger via CommandBox and activated the module in my ColdBox.cfc.

I also created a specific API route inside the module’s Router.cfc, and annotated my handler actions with the appropriate Swagger documentation tags (e.g. @hint, @response, @responses). However, when I try to access /cbSwagger, the generated JSON does not reflect my API endpoints, or sometimes the page throws errors.

I also tried defining a sample response schema (.json files) in the resources/apidocs directory, as shown in the Ortus examples, but still no success.

Can anyone help me understand what I might be missing when using cbSwagger in a modular ColdBox setup?

image
image689×754 63.3 KB

return http://127.0.0.1:8181/cbswagger:

{“openapi”:“3.0.2”,“info”:{“termsOfService”:“”,“contact”:{“email”:“”,“url”:“”,“name”:“”},“description”:“”,“version”:“1.0.0”,“title”:“My Awesome API”,“license”:{“url”:“”,“name”:“”}},“servers”:,“paths”:{“/login”:{},“/login/api/teste”:{}},“components”:{},“security”:,“tags”:}

Thanks in advance!