14 ms·
OpenAPI only describes the endpoints. Ultimately people want examples and to test their endpoints collaboratively rather than just see a description of it with
by aniforprez 3y 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
- verdverm 3y agoOpenAPI has example capabilities built in and there are many interfaces for turning the specs into WebUI https://swagger.io/docs/specification/adding-examples/ https://swagger.io/docs/specification/adding-examples/