api-guidelines
Microsoft REST API Guidelines (by microsoft)
awesome-rest
A collaborative list of great resources about RESTful API architecture, development, test, and performance (by marmelab)
| api-guidelines | awesome-rest | |
|---|---|---|
| 18 | 1 | |
| 22,997 | 3,727 | |
| 0.2% | 0.6% | |
| 6.0 | 5.2 | |
| about 2 months ago | 3 months ago | |
| GNU General Public License v3.0 or later | Creative Commons Zero v1.0 Universal |
The number of mentions indicates the total number of mentions that we've tracked plus the number of user suggested alternatives.
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.
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
Posts with mentions or reviews of api-guidelines.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2025-03-25.
-
Common Mistakes in RESTful API Design
According to Microsoft's API design guidelines, excessive nesting makes APIs brittle and difficult to evolve. The second approach provides multiple ways to access the same data depending on the consumer's needs, improving flexibility without sacrificing clarity.
-
What is a URL?
Probably a more realistic approach is described in the API guidelines from Microsoft. It admits that there is usually a collection of entities (pets in our case) we work with.
-
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
awesome-rest
Posts with mentions or reviews of awesome-rest.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2021-05-07.
-
Everything about APIs
Awesome list for resources on REST APIs Wikipedia
What are some alternatives?
When comparing api-guidelines and awesome-rest you can also consider the following projects:
OpenAPI-Specification - The OpenAPI Specification Repository
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.
Sieve - ⚗️ Clean & extensible Sorting, Filtering, and Pagination for ASP.NET Core
awesome-api-security - A collection of awesome API Security tools and resources. The focus goes to open-source tools and resources that benefit all the community.