4 ms·
100s of endpoints with various evolving payloads across 100s of developers. The problem space is shared documentation, not 'make http request'
by squiggy22 3y ago
100s of endpoints with various evolving payloads across 100s of developers.
The problem space is shared documentation, not 'make http request'
- Banditoz 3y agoI think OpenAPI is a better choice for this kinda stuff. The API docs are the source code and less lock-in that way. Devs can still use the tools they want.
- aniforprez 3y agoOpenAPI 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/