Simple RESTful API built with ASP.NET Core 2.2 to show how to create RESTful services using a decoupled, maintainable architecture.
If you want to download the original code showed on the tutorial, download the 1.0.0 tag.
1.2.1 [August 11, 2019]
BaseResponseto use generics as a way to simplify responses (see #3).
1.2.0 [July 15, 2019]
/api/productsendpoint to allow pagination (see #1).
1.1.0 [June 18, 2019]
- Added Swagger documentation through Swashbuckle;
- Added cache through native IMemoryCache;
- Changed products listing to allow filtering by category ID, to show how to perform specific queries with EF Core;
- Changed ModelState validation to use ApiController attribute and InvalidResponseFactory in Startup.
1.0.0 [February 4, 2019]
Frameworks and Libraries
- ASP.NET Core 2.2;
- Entity Framework Core (for data access);
- Entity Framework In-Memory Provider (for testing purposes);
- AutoMapper (for mapping resources and models);
- Swashbuckle (API documentation).
How to Test
First, install .NET Core 2.2. Then, open the terminal or command prompt at the API root path (
/src/Supermarket.API/) and run the following commands, in sequence:
dotnet restore dotnet run
https://localhost:5001/api/categories to check if the API is working. If you see a HTTPS security error, just add an exception to see the results.
https://localhost:5001/swagger to check the API documentation.
To test all endpoints, you'll need to use a software such as Postman.