aspnet-api-versioning
api-guidelines
Our great sponsors
aspnet-api-versioning | api-guidelines | |
---|---|---|
12 | 15 | |
2,984 | 22,391 | |
1.8% | 0.4% | |
8.7 | 8.8 | |
6 days ago | 3 days ago | |
C# | ||
MIT License | 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.
aspnet-api-versioning
-
Web API Versioning - 'apiVersion' constraint
Here is a code example
- Best way to version a CQRS-oriented REST api
- How do you handle API versioning? And naming.
- Is this a common way to version REST apis
-
Angular, ASP.NET core web api, and DTOs
- The DTOs on the server should generally not change without warning. A deprecation cycle should ideally be in place so consumers can keep up over time and front end development doesn't have to be lock-step with the services the consume. Ideally some period of time between service v1 being deprecated and service v2 being required to allow consumers to react ( in this case, you're the consumer, so be kind to yourself ). Deets: https://github.com/dotnet/aspnet-api-versioning
-
8 quick tips to improve your .NET API
This API versioning can be parameterized with some options, including the default version or even how the versioning will be done, whether by URL, header or media type. For more details, you can access the official documentation.
-
Entity Changes and API Versioning - Looking for best practice
https://github.com/dotnet/aspnet-api-versioning/tree/master/samples/aspnetcore/BasicSample/Controllers something like this
-
API version control (route name error)
Could you not achieve what you want by using ASP.NET API versioning - there's a by namespace example here
-
.NET Core — API Versioning
A lista completa pode ser vista aqui: https://github.com/microsoft/aspnet-api-versioning/wiki/Version-Format
-
Web API in 5 Hours (2021)
You don't have to use attributes. You can use conventions. See here.
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
-
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?
CleanArchitecture - Clean Architecture Solution Template for ASP.NET Core
google.aip.dev - API Improvement Proposals. https://aip.dev/
Swashbuckle.AspNetCore - Swagger tools for documenting API's built on ASP.NET Core
Sieve - ⚗️ Clean & extensible Sorting, Filtering, and Pagination for ASP.NET Core
FluentValidation - A popular .NET validation library for building strongly-typed validation rules.
free-for-dev - A list of SaaS, PaaS and IaaS offerings that have free tiers of interest to devops and infradev
ApiVersioningSwagger - Api Versioning Swagger example
OpenAPI-Specification - The OpenAPI Specification Repository
bitplatform - Build all of your apps using what you already know and love ❤️
awesome-rest - A collaborative list of great resources about RESTful API architecture, development, test, and performance
ASP.NET Boilerplate - ASP.NET Boilerplate - Web Application Framework