Genocs.WebApi 9.0.0

Requires NuGet 5.0.0 or higher.

dotnet add package Genocs.WebApi --version 9.0.0
                    
NuGet\Install-Package Genocs.WebApi -Version 9.0.0
                    
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="Genocs.WebApi" Version="9.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Genocs.WebApi" Version="9.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Genocs.WebApi" />
                    
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 Genocs.WebApi --version 9.0.0
                    
#r "nuget: Genocs.WebApi, 9.0.0"
                    
#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 Genocs.WebApi@9.0.0
                    
#: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=Genocs.WebApi&version=9.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Genocs.WebApi&version=9.0.0
                    
Install as a Cake Tool

Genocs.WebApi

Genocs Library Banner

ASP.NET Core Web API extensions and conventions for Genocs applications. Supports net10.0, net9.0, and net8.0.

Installation

dotnet add package Genocs.WebApi

Getting Started

Use this package to register Web API conventions, endpoint mapping, forwarded headers handling, and unified error handling.

Service registration:

using Genocs.WebApi;

genocs.AddWebApi();

Pipeline setup:

app.UseErrorHandler();
app.UseAllForwardedHeaders();
app.UseEndpoints(endpoints =>
{
    // Register endpoints here
});

Forwarded headers safety:

  • UseAllForwardedHeaders() is strict by default and keeps ASP.NET Core trusted network/proxy checks in place.
  • Use UseAllForwardedHeaders(resetKnownNetworksAndProxies: true) only when your deployment edge is explicitly trusted and controlled.

Endpoint authorization metadata:

  • Endpoints mapped with IEndpointsBuilder do not receive implicit anonymous metadata by default.
  • Use auth, roles, or policies parameters for authorization requirements.
  • If explicit anonymous metadata is required, add it through the endpoint convention callback.

Main Entry Points

  • AddWebApi
  • UseEndpoints
  • UseErrorHandler
  • UseAllForwardedHeaders

Validation

Use the package quality gate to validate warning baseline and regression tests:

make validate-webapi

Support

Release Notes

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 is compatible.  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 (3)

Showing the top 3 NuGet packages that depend on Genocs.WebApi:

Package Downloads
Genocs.WebApi.CQRS

CQRS extensions for Genocs ASP.NET Core Web APIs.

Genocs.WebApi.Swagger

The web api Swagger library

Genocs.WebApi.OpenApi

Swagger/OpenAPI integration for documenting Genocs Web APIs.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
9.0.0 46 5/21/2026
9.0.0-beta009 141 5/11/2026
9.0.0-beta008 176 5/2/2026
9.0.0-beta007 126 4/29/2026
9.0.0-beta006 119 4/27/2026
9.0.0-beta005 126 4/26/2026
9.0.0-beta004 129 4/18/2026
9.0.0-beta003 155 4/5/2026
9.0.0-beta002 155 3/17/2026
9.0.0-beta001 174 2/28/2026
8.1.0 218 2/8/2026
8.0.0 2,686 11/23/2025
7.5.1 2,715 10/19/2025
7.5.0 5,401 10/12/2025
7.4.1 2,126 9/19/2025
7.4.0 363 9/19/2025
7.3.0 8,470 8/14/2025
7.2.5 13,807 5/1/2025
7.2.4 2,302 4/18/2025
7.2.3 17,384 1/20/2025
Loading failed

The change log and breaking changes are listed here.
           https://github.com/Genocs/genocs-library/releases