api-guidelines
JsonApiDotNetCore
Our great sponsors
api-guidelines | JsonApiDotNetCore | |
---|---|---|
15 | 7 | |
22,379 | 652 | |
0.4% | 2.1% | |
8.8 | 9.2 | |
9 days ago | 5 days ago | |
C# | ||
GNU General Public License v3.0 or later | MIT License |
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
-
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.
JsonApiDotNetCore
-
Ask HN: Nested Resources in REST/HTTP API URLs?
Well, that might be true when implementing from the scratch, but using a standard often also means, that someone has implemented a well known library to get rid of the boilerplate and basic decisions.
I personally often use jsonapi.net[1], a C# implementation of JSONAPI. This supports OpenAPI/Swagger with swashbuckle, has a very good filtering implementation and together with Orbit.js[2] it is pretty much without having to decide many things...
[1]: https://www.jsonapi.net/
- Ask HN: What's is your go to toolset for simple front end development?
- Recommendation reading (books/blogs) for best practices while designing REST APIs
-
Composing and nesting with JsonApiDotNetCore
It's so powerful that it even allows you to establish relationships between operations within a single request, using something called local IDs. Work is progressing quickly on the atomic-operations branch. Check it out on Github if you want to follow along.
-
Relationships
In our previous post we setup a basic JSON:API compliant API with the 4.0 release of the JsonApiDotNetCore framework. You can find the code we wrote under the part-1 branch on Github.
What are some alternatives?
google.aip.dev - API Improvement Proposals. https://aip.dev/
ServiceStack - Thoughtfully architected, obscenely fast, thoroughly enjoyable web services for all
Sieve - ⚗️ Clean & extensible Sorting, Filtering, and Pagination for ASP.NET Core
FFImageLoading - Fast & Furious Image Loading - Image loading, caching & transforming library for Xamarin and Windows
free-for-dev - A list of SaaS, PaaS and IaaS offerings that have free tiers of interest to devops and infradev
NancyFx - Lightweight, low-ceremony, framework for building HTTP based services on .Net and Mono. Note: This project is no longer maintained and has been archived.
OpenAPI-Specification - The OpenAPI Specification Repository
GraphQL for .NET - GraphQL for .NET
awesome-rest - A collaborative list of great resources about RESTful API architecture, development, test, and performance
Hot Chocolate - Welcome to the home of the Hot Chocolate GraphQL server for .NET, the Strawberry Shake GraphQL client for .NET and Banana Cake Pop the awesome Monaco based GraphQL IDE.
Swashbuckle.AspNetCore - Swagger tools for documenting API's built on ASP.NET Core
Breeze - Breeze for C#, F#, and VB.NET client applications