Hacker News new | ask | show | jobs
by aniforprez 983 days ago
OpenAPI only describes the endpoints. Ultimately people want examples and to test their endpoints collaboratively rather than just see a description of it with the fields it accepts. Actual use cases and a proper flow of being able to authenticate and use that token to call the other APIs and check the responses is what people seem to want more than a "dumb" curl GUI
1 comments

OpenAPI has example capabilities built in and there are many interfaces for turning the specs into WebUI

https://swagger.io/docs/specification/adding-examples/