swagger-tools
webmachine
Our great sponsors
swagger-tools | webmachine | |
---|---|---|
1 | 2 | |
699 | 1,498 | |
- | -0.1% | |
0.0 | 2.9 | |
almost 2 years ago | 2 months ago | |
JavaScript | Erlang | |
MIT License | Apache License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
swagger-tools
-
Best Practices for REST API Design
The above referenced PoC service based on express uses https://github.com/apigee-127/swagger-tools which surfaces a web app by which front end devs navigate through the published API endpoints. They can use the web app to call the service via the endpoint or copy and paste sample code that calls the service. Most open api integrations support this kind of functionality.
webmachine
- Work in progress on a port of Webmachine
-
Best Practices for REST API Design
I interrupted my reading at 'Accept and respond with JSON' to write this comment, before I skipped over that section and returned to reading the rest.
Folks that aren't aware of Webmachine should take a look:
https://github.com/webmachine/webmachine
The 'Accept' header should determine the response type, but content negotiation is something that few bother to implement. Webmachine does that for you.
Also, shameless plug for my OCaml port:
https://github.com/inhabitedtype/ocaml-webmachine
What are some alternatives?
OpenAPI-Specification - The OpenAPI Specification Repository
api-guidelines - Microsoft REST API Guidelines
google.aip.dev - API Improvement Proposals. https://aip.dev/
grpc-gateway - gRPC to JSON proxy generator following the gRPC HTTP spec
http-decision-diagram - An activity diagram to describe the resolution of HTTP response status codes, given various headers.
cl-webmachine - HTTP Semantic Awareness on top of Hunchentoot
snooze - Common Lisp RESTful web development