api-guidelines
google.aip.dev
| api-guidelines | google.aip.dev | |
|---|---|---|
| 16 | 1 | |
| 22,411 | 997 | |
| 0.3% | 1.4% | |
| 8.8 | 8.1 | |
| 7 days ago | 8 days ago | |
| Shell | ||
| GNU General Public License v3.0 or later | GNU General Public License v3.0 or later |
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.
api-guidelines
-
5 Things I wanted to know about REST API when I was starting
AZURE API Guidelines
-
Mastering API Design: 26 Resources for Software Engineers
📝 "Microsoft REST API Guidelines" [link]
- Ask HN: Any book recommendations for API design?
- What are the best practices that you, your team or your company follows while developing apis or while writing api contracts?
- Recommendations for resources about REST APIs?
- Best Practice/Standars for API Management endpoints
- Ask HN: Standards for API Error Responses
-
Recommendation reading (books/blogs) for best practices while designing REST APIs
This is a great, thorough and in-depth document from Microsoft: https://github.com/microsoft/api-guidelines/blob/vNext/Guidelines.md
-
Looking for understandable good practices concerning structure of json returned
Thing is, I made some researches this morning, and I found nowhere a "data" wrapper, not in Microsoft API best practices [FR] (client is using Microsoft APIs), not in Microsoft API guidelines, not in OpenAPI offical specifications, nowhere in any blog I found this morning.
-
Everything about APIs
Microsoft REST API guidelines
google.aip.dev
-
Best Practices for REST API Design
As to updates (and other aspects of API design too), I highly recommend taking a look at the solutions proposed at https://aip.dev - e.g. in case of update, https://aip.dev/134 (though there's some slight not-yet-resolved inconsistency observed recently by one user: https://github.com/aip-dev/google.aip.dev/issues/673)
What are some alternatives?
Sieve - ⚗️ Clean & extensible Sorting, Filtering, and Pagination for ASP.NET Core
OpenAPI-Specification - The OpenAPI Specification Repository
free-for-dev - A list of SaaS, PaaS and IaaS offerings that have free tiers of interest to devops and infradev
grpc-gateway - gRPC to JSON proxy generator following the gRPC HTTP spec
swagger-tools - A Node.js and browser module that provides tooling around Swagger.
awesome-rest - A collaborative list of great resources about RESTful API architecture, development, test, and performance
http-decision-diagram - An activity diagram to describe the resolution of HTTP response status codes, given various headers.
Swashbuckle.AspNetCore - Swagger tools for documenting API's built on ASP.NET Core
webmachine - A REST-based system for building web applications.
awesome-grpc - A curated list of useful resources for gRPC
awesome-api - A curated list of awesome resources for design and implement RESTful API's.