swagger-tools
A Node.js and browser module that provides tooling around Swagger. (by apigee-127)
api-guidelines
Microsoft REST API Guidelines (by microsoft)
Our great sponsors
| swagger-tools | api-guidelines | |
|---|---|---|
| 1 | 15 | |
| 699 | 22,391 | |
| - | 0.4% | |
| 0.0 | 8.8 | |
| almost 2 years ago | 7 days ago | |
| JavaScript | ||
| MIT License | GNU General Public License v3.0 or later |
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.
swagger-tools
Posts with mentions or reviews of swagger-tools.
We have used some of these posts to build our list of alternatives
and similar projects. The last one was on 2021-02-22.
-
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.
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 2023-12-20.
-
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
-
Library for Filtering/Sorting/Pagination Microsoft Style
I'm working on a web API where I'd like to follow the Microsoft API Guidelines. I thought this would be easy, because surely there would be plenty of libraries out there to support their guidelines, maybe Microsoft even has one out there (I thought). I haven't been able to find any.
What are some alternatives?
When comparing swagger-tools and api-guidelines you can also consider the following projects:
OpenAPI-Specification - The OpenAPI Specification Repository
google.aip.dev - API Improvement Proposals. https://aip.dev/
Sieve - ⚗️ Clean & extensible Sorting, Filtering, and Pagination for ASP.NET Core
grpc-gateway - gRPC to JSON proxy generator following the gRPC HTTP spec
free-for-dev - A list of SaaS, PaaS and IaaS offerings that have free tiers of interest to devops and infradev
http-decision-diagram - An activity diagram to describe the resolution of HTTP response status codes, given various headers.
webmachine - A REST-based system for building web applications.
awesome-rest - A collaborative list of great resources about RESTful API architecture, development, test, and performance
Swashbuckle.AspNetCore - Swagger tools for documenting API's built on ASP.NET Core
awesome-grpc - A curated list of useful resources for gRPC
swagger-tools vs OpenAPI-Specification
api-guidelines vs google.aip.dev
swagger-tools vs google.aip.dev
api-guidelines vs Sieve
swagger-tools vs grpc-gateway
api-guidelines vs free-for-dev
swagger-tools vs http-decision-diagram
api-guidelines vs OpenAPI-Specification
swagger-tools vs webmachine
api-guidelines vs awesome-rest
api-guidelines vs Swashbuckle.AspNetCore
api-guidelines vs awesome-grpc