devdeer.Libraries.AspNetCore.RestApi 19.0.2

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package devdeer.Libraries.AspNetCore.RestApi --version 19.0.2
                    


                    

                
NuGet\Install-Package devdeer.Libraries.AspNetCore.RestApi -Version 19.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="devdeer.Libraries.AspNetCore.RestApi" Version="19.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="devdeer.Libraries.AspNetCore.RestApi" Version="19.0.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="devdeer.Libraries.AspNetCore.RestApi" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add devdeer.Libraries.AspNetCore.RestApi --version 19.0.2
                    


                    

                
#r "nuget: devdeer.Libraries.AspNetCore.RestApi, 19.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package devdeer.Libraries.AspNetCore.RestApi@19.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=devdeer.Libraries.AspNetCore.RestApi&version=19.0.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=devdeer.Libraries.AspNetCore.RestApi&version=19.0.2
                    


                            Install as a Cake Tool

devdeer.Libraries.AspNetCore.RestApi

Disclaimer

If you want to use this package you should be aware of some principles and practices we at DEVDEER use. So be aware that this is not backed by a public repository. The purpose here is to give out customers easy access to our logic. Nevertheless you are welcome to use this lib if it provides any advantages.

Summary

This package is used to provide startup logic, base types and other specific logic to ASP.NET Core API projects.

Please keep in mind that this package is not intended to be used in UI web projects!

Usage

One of the main purposes for this packages was the fact, that the initial configuration of ASP.NET APIs can be overwhelming. You need to inject dependencies and app components in the correct order. Also you often want to put configuration of those things to outside stores (appsettings.json in our case). This package now reduces all of this to only some lines of code. You could use this as follows in the Program.cs:

var options = new ConfigurationOptions
{
    // your explicit options and callbacks
};
var builder = WebApplication.CreateBuilder(args);
builder.Host.ConfigureLogging();
builder.Services.ConfigureServices(builder.Configuration, options);
// your additional DI here
var app = builder.Build();
app.ConfigureDefaults(options);
app.Run();

Now it is crucial to unserstand that ConfigureLogging(), ConfigureServices() and ConfigureDefaults() are methods coming from this package. The outcome can be controlled in 2 ways:

  1. Usage of ConfigurationOptions. You can define some of the wanted behavior using this type and pass it in.
  2. Putting elements in your appsettings.*.json.

Some common app settings are:

{
    "AzureAd": {
		"Instance": "https://login.microsoftonline.com/",
		"TenantId": "",
		"Domain": ""
	},
	"Cors": {
		"EnableCors": true,
		"AllowCredentials": false,
		"AllowedHeaders": ["*"],
		"AllowedMethods": ["GET", "POST"]
	},
    "Swagger": {
		"ApiDescription": "",
		"DeprecatedApiMessage": "<p><strong><span style='color:white;background-color:red'>DEPRECATED</span></strong></p>",
		"Contact": {
			"Name": "",
			"Email": ""
		},
		"SupportedVersions": [{
			"Major": 1,
			"Minor": 0
		}],
		"Enable": true
	}
}

Using the syntax above will automatically configure the respective services in the correct order with just two lines of code.

More Details

Swagger

We are automatically referencing Swashbuckle and configuring it if the app is running in Development and the app config tells us to do it. By default we are using versioned APIs meaning that all controllers are expected to expose endpoints using a version.

Authentication

If the AzureAd config option is set we automatically configure authentication to AzureAD or Azure AD B2C.

About DEVDEER

DEVDEER is a company from Magdeburg, Germany which is specialized in consulting, project management and development. We are very focussed on Microsoft Azure as a platform to run our products and solutions in the cloud. So all of our backend components usually runs in this environment and is developed using .NET. In the frontend area we are using react and a huge bunch of packages to build our UIs.

You can find us online:

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
23.0.1 39 12/21/2025
23.0.0 108 12/13/2025
22.4.2 436 12/11/2025
22.4.1 403 12/11/2025
22.4.0 199 12/5/2025
22.3.4 229 11/28/2025
22.3.3 193 11/22/2025
22.3.2 182 11/22/2025
22.3.1 348 11/21/2025
22.3.0 323 11/21/2025
22.2.2 235 11/7/2025
22.2.1 410 10/21/2025
22.2.0 174 10/18/2025
22.1.9 243 10/15/2025
22.1.8 180 10/15/2025
22.1.7 188 10/15/2025
22.1.6 179 10/15/2025
22.1.5 201 10/15/2025
22.1.4 186 10/14/2025
22.1.3 198 10/13/2025
22.1.2 214 10/12/2025
22.1.1 176 10/12/2025
22.1.0 160 10/12/2025
22.0.5 143 10/11/2025
22.0.4 120 10/11/2025
22.0.3 126 10/11/2025
22.0.2 118 10/11/2025
22.0.1 128 10/11/2025
22.0.0 117 10/11/2025
21.2.5 217 10/7/2025
21.2.4 193 10/7/2025
21.2.3 194 10/7/2025
21.2.2 204 10/6/2025
21.2.1 187 10/6/2025
21.2.0 193 10/6/2025
21.1.8 194 10/6/2025
21.1.7 187 10/6/2025
21.1.6 186 10/6/2025
21.1.5 189 10/6/2025
21.1.4 195 10/4/2025
21.1.2 186 10/4/2025
21.1.1 179 10/4/2025
21.0.2 129 10/4/2025
21.0.1 197 9/29/2025
21.0.0 146 9/27/2025
20.2.4 520 8/28/2025
20.2.3 251 8/28/2025
20.2.2 417 8/13/2025
20.2.1 280 7/29/2025
20.2.0 147 7/29/2025
20.1.5 178 7/29/2025
20.1.4 164 7/29/2025
20.1.3 622 7/22/2025
20.1.2 576 7/22/2025
20.1.0 233 7/17/2025
20.0.2 212 7/17/2025
20.0.1 212 7/16/2025
20.0.0 198 7/16/2025
19.1.1 682 6/11/2025
19.1.0 202 5/30/2025
19.0.2 361 5/16/2025
19.0.1 286 5/16/2025
19.0.0 339 4/11/2025
18.0.1 390 3/18/2025
18.0.0 294 2/14/2025
17.1.7 711 1/15/2025
17.1.6 208 1/15/2025
17.1.5 647 1/8/2025
17.1.4 300 1/6/2025
17.1.3 242 1/6/2025
17.1.2 228 1/5/2025
17.1.1 212 1/5/2025
17.1.0 233 1/4/2025
17.0.2 580 12/24/2024
17.0.1 381 12/13/2024
17.0.0 327 12/11/2024
16.5.0 916 12/2/2024
16.4.7 330 11/1/2024
16.4.6 288 10/30/2024
16.4.5 226 10/30/2024
16.4.4 207 10/30/2024
16.4.3 605 10/27/2024
16.4.2 220 10/27/2024
16.4.1 201 10/27/2024
16.4.0 233 10/27/2024
16.3.3 339 10/14/2024
16.3.2 233 10/14/2024
16.3.1 267 10/12/2024
16.3.0 306 10/3/2024
16.2.2 532 8/23/2024
16.2.1 701 6/27/2024
16.2.0 214 6/27/2024
16.1.5 545 6/12/2024
16.1.4 227 6/12/2024
16.1.3 521 5/30/2024
16.1.2 231 5/29/2024
16.1.1 220 5/28/2024
16.1.0 222 5/28/2024
16.0.0 252 5/24/2024
15.0.1 251 5/19/2024
15.0.0 268 5/14/2024
14.4.3 228 5/14/2024
14.4.1 460 4/19/2024
14.4.0 246 4/19/2024
14.3.0 362 3/21/2024
14.2.0 459 3/11/2024
14.1.1 248 3/9/2024
14.1.0 249 3/9/2024
14.0.1 519 2/18/2024
14.0.0 694 1/20/2024
13.0.5 244 1/18/2024
13.0.4 630 12/25/2023
13.0.3 250 12/25/2023
13.0.2 420 12/11/2023
13.0.0 265 12/10/2023
12.7.5 387 11/9/2023
12.7.4 222 11/9/2023
12.7.3 288 10/29/2023
12.7.2 251 10/29/2023
12.7.1 319 9/27/2023
12.7.0 263 9/16/2023
12.6.4 263 9/14/2023
12.6.2 286 9/8/2023
12.6.1 267 9/7/2023
12.6.0 258 9/6/2023
12.5.0 590 8/15/2023
12.4.1 236 8/15/2023
12.4.0 276 8/15/2023
12.3.0 832 5/30/2023
12.2.1 315 5/29/2023
12.2.0 302 5/24/2023
12.1.0 305 5/24/2023
12.0.0 334 5/24/2023
11.0.5 834 5/23/2023
11.0.4 316 5/23/2023
11.0.3 278 5/23/2023
11.0.2 363 5/21/2023
11.0.1 312 5/21/2023
11.0.0 317 5/21/2023
10.6.0 337 5/21/2023
10.5.13 1,143 4/12/2023
10.5.12 369 4/12/2023
10.5.11 357 4/12/2023
10.5.10 626 4/12/2023
10.5.9 386 4/6/2023
10.5.8 590 3/14/2023
10.5.7 396 3/14/2023
10.5.6 803 3/11/2023
10.5.5 847 1/13/2023
10.5.4 711 1/10/2023
10.5.3 493 1/4/2023
10.5.2 464 1/3/2023
10.5.1 612 12/29/2022
10.5.0 709 12/29/2022
10.4.2 483 12/29/2022
10.4.0 837 12/23/2022
10.2.24 1,574 10/19/2022
10.2.23 589 10/19/2022
10.2.22 548 10/18/2022
10.2.21 553 10/17/2022
10.2.20 571 10/17/2022
10.2.19 583 10/17/2022
10.2.18 847 9/13/2022
10.2.17 1,449 9/13/2022
10.2.16 1,053 9/7/2022
10.2.15 857 9/6/2022
10.2.14 1,219 9/6/2022
10.2.13 622 9/6/2022
10.2.12 841 9/6/2022
10.2.11 847 9/6/2022
10.2.10 794 9/6/2022
10.2.9 1,067 9/5/2022
10.2.8 726 8/15/2022
10.2.7 659 8/13/2022
10.2.6 799 8/5/2022
10.2.5 779 7/19/2022
10.2.4 1,440 5/16/2022
10.2.3 689 5/16/2022
10.2.2 1,627 3/20/2022
10.2.0 803 3/20/2022
10.1.1 823 3/18/2022
10.1.0 787 3/14/2022
10.0.0 825 3/1/2022
9.0.4 861 2/28/2022
9.0.3 1,965 1/24/2022
9.0.2 737 12/22/2021
9.0.1 556 12/22/2021
9.0.0 549 12/22/2021
8.0.5 1,140 12/1/2021
8.0.3 1,214 8/14/2021
8.0.2 740 8/14/2021
8.0.1 836 8/14/2021
8.0.0 652 8/9/2021
7.0.13 1,545 7/12/2021
7.0.12 1,070 6/9/2021
7.0.11 1,564 5/1/2021
7.0.10 1,204 5/1/2021
1.4.0 960 8/25/2020

- BREAKING: AutoMapper is replaced by Mapster. We no longer support AutoMapper-releated functionallities in the ConfigurationOptions. Thus no need for explicit configuration of mapping is needed.
- BREAKING: In order to initialize type mappings call `TypeAdapterConfig<TEntity, TModel>.NewConfig().Map(...).TwoWays()` in your Main method.
- BREAKING: AfterModelMapping, EntityToModelResolver, BeforeSingleMapping and AfterSingleMapping where removed.
- BREAKING: Configuration.AutoRegisterModelMapping is obsolete now.
- Dependency updates.