3 ms·
This was/(is?) one of the goals of Swagger[0]. Lots of promises, but have yet to see it work in the wild. I want to use whatever Stripe uses for their API desig
by nathancahill 10y ago
This was/(is?) one of the goals of Swagger[0]. Lots of promises, but have yet to see it work in the wild. I want to use whatever Stripe uses for their API design.
[0] http://swagger.io/ http://swagger.io/
- niftich 10y agoYes, Swagger is intended to be a service description in this space. But goa seems to allow you to do your design in their DSL and then generate a Swagger spec from it [1]. [1] http://goa.design/design/swagger/ http://goa.design/design/swagger/
- nathancahill 10y agoWe must go deeper.
- seanp2k2 10y agoTodo: write a thing that makes Goa from a RailsAPI server. The goal is to have it be able to generate the same exact RailsAPI code. The usefulness is that a different team not as comfortable with Rails could use the generated Goa code to generate the same RailsAPI server in the language they're comfortable working with, make their contributions, and have that generate new Goa, which the first team would use to generate the updated RailsAPI code. Kind of a Rosetta Stone for APIs, but only useful if it works both ways, picks up every small change in exacting detail, and works server ->spec ->same server. Not sure if that's even possible, but it'd be cool.
- nathancahill 10y agoHave you seen this? https://github.com/mame/quine-relay https://github.com/mame/quine-relay
- supergeek133 10y agohttps://github.com/lord/slate https://github.com/lord/slate
- hakanito 10y agohttps://readme.io https://readme.io