Published rest services: How to document undocumented response codes?

0
The goal is to document published API's properly. The automated Swagger documentation seems decent, but nonstandard response codes are not documented. How can I document these response codes properly? If someone could tell me where to find the original swagger.json file for copying, pasting and editing on disk, that would help a lot! (When running the published rest service demo project locally, I found it here on the server: http://localhost:8080/rest-doc/rest/prsorderservice/v1/swagger.json; I need to know where it's located so that I can replace the original with a better version so that I can publish the API with minimal effort)   update: I know I can export the swagger.json via rightclicking on the service inside the project explorer, but I need to know how I can replace that json so that the new info is also used after I update the published REST service.
asked
2 answers
2

Hi Wouter,

This is not possible at this moment. 

Was originally part of this idea: https://forum.mendix.com/link/ideas/693 but was not implemented.

My suggestion is to create this idea separate, you got my vote! ☑

answered
0

Is this feature already implemented?
The documentation section of a published API should be possible to manipulate to avoid confussion with integration partners/users.

answered