Hacker News Reader

Swagger UI seems to do a pretty decent job. The thing I like about swagger is you create one canonical description of your API and model and then generate postman collections, API docs, and client/server stubs all from the same source.

Swagger is now OpenAPI with backing from many major corporations. We use it to deploy APIs tailored to each customer, as we can adapt the view and still reuse controllers and models. Documented and maintained.

Plugging a competitor here, but I believe Postman has the ability to generate documentation.

And it can also generate program code for a lot of languages, curl or wget requests etc, and is has the interceptor plugin.. cant really be beaten at this time...

Postman has a tonne of features, but this also makes the UI more difficult to learn an use. This is one of the reasons I created Insomnia.

P.S. Insomnia also has code generation https://insomnia.rest/documentation/code-snippets/

http://apidocjs.com/ it creates a documentation from annotations within your code.

Have you tried Swagger?

Same here, it seems this is still a huge hassle.

Try stoplight.io