Popularity
5.8
Growing
Activity
9.2
Growing
685
26
159

Description

A framework for building JSON:API compliant REST APIs using .NET Core and Entity Framework Core.

The ultimate goal of this library is to eliminate as much boilerplate as possible by offering out-of-the-box features such as sorting, filtering and pagination. You just need to focus on defining the resources and implementing your custom business logic. This library has been designed around dependency injection, making extensibility incredibly easy.

Programming language: C#
License: MIT License
Tags: API     REST     Entity-framework-core     AspNetCore     Dotnetcore    

JsonApiDotNetCore alternatives and similar packages

Based on the "API" category.
Alternatively, view JsonApiDotNetCore alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of JsonApiDotNetCore or a related project?

Add another 'API' Package

Popular Comparisons

README

JsonApiDotNetCore

A framework for building JSON:API compliant REST APIs using .NET Core and Entity Framework Core. Includes support for Atomic Operations.

Build Coverage NuGet Chat FIRST-TIMERS

The ultimate goal of this library is to eliminate as much boilerplate as possible by offering out-of-the-box features such as sorting, filtering and pagination. You just need to focus on defining the resources and implementing your custom business logic. This library has been designed around dependency injection, making extensibility incredibly easy.

Getting Started

These are some steps you can take to help you understand what this project is and how you can use it:

About

Official documentation

Related Projects

Examples

See the examples directory for up-to-date sample applications. There is also a Todo List App that includes a JsonApiDotNetCore API and an EmberJs client.

Installation and Usage

See our documentation for detailed usage.

Models

#nullable enable

[Resource]
public class Article : Identifiable<int>
{
    [Attr]
    public string Name { get; set; } = null!;
}

Middleware

// Program.cs

builder.Services.AddJsonApi<AppDbContext>();

// ...

app.UseRouting();
app.UseJsonApi();
app.MapControllers();

Compatibility

The following chart should help you pick the best version, based on your environment. See also our [versioning policy](./VERSIONING_POLICY.md).

JsonApiDotNetCore Status .NET Entity Framework Core
3.x Stable Core 2.x 2.x
4.x Stable Core 3.1 3.1
Core 3.1 5
5 5
6 5
5.0.0-5.0.2 Stable 6 6
5.0.3+ Stable 6 6
6 7
7 7

Contributing

Have a question, found a bug or want to submit code changes? See our [contributing guidelines](./.github/CONTRIBUTING.md).

Trying out the latest build

After each commit to the master branch, a new prerelease NuGet package is automatically published to AppVeyor at https://ci.appveyor.com/nuget/jsonapidotnetcore. To try it out, follow the next steps:

  • In Visual Studio: Tools, NuGet Package Manager, Package Manager Settings, Package Sources
  • Open the NuGet package manager console (Tools, NuGet Package Manager, Package Manager Console)
    • Select AppVeyor JADNC as package source
    • Run command: Install-Package JonApiDotNetCore -pre

Development

To build the code from this repository locally, run:

dotnet build

Running tests locally requires access to a PostgreSQL database. If you have docker installed, this can be propped up via:

pwsh run-docker-postgres.ps1

And then to run the tests:

dotnet test

Alternatively, to build and validate the code, run all tests, generate code coverage and produce the NuGet package:

pwsh Build.ps1