{"id":27063608,"url":"https://github.com/Research-Institute/json-api-dotnet-core","last_synced_at":"2025-04-05T16:01:51.616Z","repository":{"id":37271604,"uuid":"66287660","full_name":"json-api-dotnet/JsonApiDotNetCore","owner":"json-api-dotnet","description":"A framework for building JSON:API compliant REST APIs using ASP.NET and Entity Framework Core.","archived":false,"fork":false,"pushed_at":"2024-10-24T12:56:36.000Z","size":51120,"stargazers_count":679,"open_issues_count":38,"forks_count":159,"subscribers_count":27,"default_branch":"master","last_synced_at":"2024-10-25T14:42:37.821Z","etag":null,"topics":["aspnet","dotnet","ef-core","json-api","jsonapi-server","rest-api","web-api"],"latest_commit_sha":null,"homepage":"https://www.jsonapi.net","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/json-api-dotnet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"json-api-dotnet"}},"created_at":"2016-08-22T16:08:10.000Z","updated_at":"2024-10-21T21:15:17.000Z","dependencies_parsed_at":"2023-10-26T18:25:07.660Z","dependency_job_id":"f349715d-09f1-43f1-842c-ca4e59e76f5f","html_url":"https://github.com/json-api-dotnet/JsonApiDotNetCore","commit_stats":null,"previous_names":["research-institute/json-api-dotnet-core"],"tags_count":110,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/json-api-dotnet%2FJsonApiDotNetCore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/json-api-dotnet%2FJsonApiDotNetCore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/json-api-dotnet%2FJsonApiDotNetCore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/json-api-dotnet%2FJsonApiDotNetCore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/json-api-dotnet","download_url":"https://codeload.github.com/json-api-dotnet/JsonApiDotNetCore/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247361593,"owners_count":20926641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aspnet","dotnet","ef-core","json-api","jsonapi-server","rest-api","web-api"],"created_at":"2025-04-05T16:01:34.458Z","updated_at":"2025-04-05T16:01:51.590Z","avatar_url":"https://github.com/json-api-dotnet.png","language":"C#","funding_links":["https://github.com/sponsors/json-api-dotnet"],"categories":["Frameworks, Libraries and Tools","框架, 库和工具","API"],"sub_categories":["API"],"readme":"\u003ca href=\"https://www.jsonapi.net\"\u003e\u003cimg src=\"docs/home/assets/img/logo.svg\" style=\"height: 345px; width: 345px\"/\u003e\u003c/a\u003e\n\n# JsonApiDotNetCore\nA framework for building [JSON:API](https://jsonapi.org/) compliant REST APIs using .NET Core and Entity Framework Core. Includes support for [Atomic Operations](https://jsonapi.org/ext/atomic/).\n\n[![Build](https://github.com/json-api-dotnet/JsonApiDotNetCore/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/json-api-dotnet/JsonApiDotNetCore/actions/workflows/build.yml?query=branch%3Amaster)\n[![Coverage](https://codecov.io/gh/json-api-dotnet/JsonApiDotNetCore/branch/master/graph/badge.svg?token=pn036tWV8T)](https://codecov.io/gh/json-api-dotnet/JsonApiDotNetCore)\n[![NuGet](https://img.shields.io/nuget/v/JsonApiDotNetCore.svg)](https://www.nuget.org/packages/JsonApiDotNetCore/)\n[![Chat](https://badges.gitter.im/json-api-dotnet-core/Lobby.svg)](https://gitter.im/json-api-dotnet-core/Lobby?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![FIRST-TIMERS](https://img.shields.io/badge/first--timers--only-friendly-blue.svg)](https://www.firsttimersonly.com/)\n\nThe 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.\n\n## Getting Started\n\nThese are some steps you can take to help you understand what this project is and how you can use it:\n\n### About\n- [What is JSON:API and why should I use it?](https://nordicapis.com/the-benefits-of-using-json-api/) (blog, 2017)\n- [Pragmatic JSON:API Design](https://www.youtube.com/watch?v=3jBJOga4e2Y) (video, 2017)\n- [JSON:API and JsonApiDotNetCore](https://www.youtube.com/watch?v=79Oq0HOxyeI) (video, 2021)\n- [JsonApiDotNetCore Release 4.0](https://dev.to/wunki/getting-started-5dkl) (blog, 2020)\n- [JSON:API, .Net Core, EmberJS](https://youtu.be/KAMuo6K7VcE) (video, 2017)\n- [Embercasts: Full Stack Ember with ASP.NET Core](https://www.embercasts.com/course/full-stack-ember-with-dotnet/watch/whats-in-this-course-cs) (paid course, 2017)\n\n### Official documentation\n- [The JSON:API specification](https://jsonapi.org/format/)\n- [JsonApiDotNetCore website](https://www.jsonapi.net/)\n- [Roadmap](ROADMAP.md)\n\n## Related Projects\n\n- [Performance Reports](https://github.com/json-api-dotnet/PerformanceReports)\n- [JsonApiDotNetCore.MongoDb](https://github.com/json-api-dotnet/JsonApiDotNetCore.MongoDb)\n- [Ember.js Todo List App](https://github.com/json-api-dotnet/TodoListExample)\n\n## Examples\n\nSee the [examples](https://github.com/json-api-dotnet/JsonApiDotNetCore/tree/master/src/Examples) directory for up-to-date sample applications. There is also a [Todo List App](https://github.com/json-api-dotnet/TodoListExample) that includes a JsonApiDotNetCore API and an EmberJs client.\n\n## Installation and Usage\n\nSee [our documentation](https://www.jsonapi.net/) for detailed usage.\n\n### Models\n\n```c#\n#nullable enable\n\n[Resource]\npublic class Article : Identifiable\u003cint\u003e\n{\n    [Attr]\n    public string Name { get; set; } = null!;\n}\n```\n\n### Middleware\n\n```c#\n// Program.cs\n\nbuilder.Services.AddJsonApi\u003cAppDbContext\u003e();\n\n// ...\n\napp.UseRouting();\napp.UseJsonApi();\napp.MapControllers();\n```\n\n## Compatibility\n\nThe following chart should help you pick the best version, based on your environment.\nSee also our [versioning policy](./VERSIONING_POLICY.md).\n\n| JsonApiDotNetCore | Status       | .NET     | Entity Framework Core |\n| ----------------- | ------------ | -------- | --------------------- |\n| 3.x               | Stable       | Core 2.x | 2.x                   |\n| 4.x               | Stable       | Core 3.1 | 3.1, 5                |\n|                   |              | 5        | 5                     |\n|                   |              | 6        | 5                     |\n| 5.0.0-5.0.2       | Stable       | 6        | 6                     |\n| 5.0.3-5.4.0       | Stable       | 6        | 6, 7                  |\n|                   |              | 7        | 7                     |\n| 5.5+              | Stable       | 6        | 6, 7                  |\n|                   |              | 7        | 7                     |\n|                   |              | 8        | 8, 9                  |\n|                   |              | 9        | 9                     |\n| master            | Preview      | 8        | 8, 9                  |\n|                   |              | 9        | 9                     |\n| openapi           | Experimental | 8        | 8, 9                  |\n|                   |              | 9        | 9                     |\n\n## Contributing\n\nHave a question, found a bug or want to submit code changes? See our [contributing guidelines](./.github/CONTRIBUTING.md).\n\n## Trying out the latest build\n\nAfter each commit to the master branch, a new pre-release NuGet package is automatically published to [GitHub Packages](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry).\nTo try it out, follow the steps below:\n\n1. [Create a Personal Access Token (classic)](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-personal-access-token-classic) with at least `read:packages` scope.\n1. Add our package source to your local user-specific `nuget.config` file by running:\n   ```bash\n   dotnet nuget add source https://nuget.pkg.github.com/json-api-dotnet/index.json --name github-json-api --username YOUR-GITHUB-USERNAME --password YOUR-PAT-CLASSIC\n   ```\n   In the command above:\n   - Replace YOUR-GITHUB-USERNAME with the username you use to login your GitHub account.\n   - Replace YOUR-PAT-CLASSIC with the token your created above.\n   \n   :warning: If the above command doesn't give you access in the next step, remove the package source by running:\n   ```bash\n   dotnet nuget remove source github-json-api\n   ```\n   and retry with the `--store-password-in-clear-text` switch added.\n1. Restart your IDE, open your project, and browse the list of packages from the github-json-api feed (make sure pre-release packages are included).\n\n## Development\n\nTo build the code from this repository locally, run:\n\n```bash\ndotnet build\n```\n\nRunning tests locally requires access to a PostgreSQL database. If you have docker installed, this can be propped up via:\n\n```bash\npwsh run-docker-postgres.ps1\n```\n\nAnd then to run the tests:\n\n```bash\ndotnet test\n```\n\nAlternatively, to build, run all tests, generate code coverage and NuGet packages:\n\n```bash\npwsh Build.ps1\n```\n\n## Sponsors\n\n\u003ca href=\"https://jb.gg/OpenSourceSupport\"\u003e\u003cimg align=\"middle\" src=\"https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg\" alt=\"JetBrains Logo\" style=\"width:150px\"\u003e\u003c/a\u003e \u0026nbsp;\n\u003ca href=\"https://www.araxis.com/buy/open-source\"\u003e\u003cimg align=\"middle\" src=\"https://www.araxis.com/theme/37/img/araxis-logo-lg.svg\" alt=\"Araxis Logo\" style=\"width:150px\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FResearch-Institute%2Fjson-api-dotnet-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FResearch-Institute%2Fjson-api-dotnet-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FResearch-Institute%2Fjson-api-dotnet-core/lists"}