VerticalApi 2025.1.8.175842

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

Introduction

VerticalApi is intended to be a simple implementation of Vertical slicing and Minimal Api at the same time.
By allowing simplistic folder structure and a minimal amount of boilerplate code it creates an easy way to setup individual endpoints and maintaining them over time.

Setup

Mapping endpoints

In the following example all endpoints relevant to public access will be mapped.
This is done by setting the property NamespaceRoot to endpoints/public.
The setting will map all found endpoints contained in the ApplicationNameSpace.endpoints.public

app.MapEndpoints(new EndpointOptions()
{
  NamespaceRoot = "endpoints/public",
  ApiBasePath = "api/public",
});

Endpoint Options

NameSpaceRoot:

Reflects the root of the namespace desired to be mapped.

Example: ApplicationNamespace.Area.Endpoints can be mapped with area/endpoints
Example: ApplicationNamespace.Endpoints.Public can be mapped with endpoints/public

ApiBasePath:

Sets the base path for the mapped endpoint.
Example: api/public will become https://domain.com/api/public/*
Example: endpoints/public will become https://domain.com/endpoints/public/*

RequireAuthorization:

If endpoints in the mapping should be authorized, set this to true.
It is necessary for app.UseAuthorization() to be called before mapping for authorization to be enabled.
Note: The [AllowAnonymous] attribute will override the authorization requirement on individual endpoints

AuthenticationScheme:

Set the desired authentication scheme that should apply to the given endpoints. Note: Requires the RequireAuthorization attribute to be enabled, as well as app.UseAuthentication()

CorsPolicyName:

Sets the name for the Cors policy to be used with the mapped endpoints.
Note: Requires app.UseCors() to be set.

Endpoint file

The endpoint file will consist of a class containing one or more methods that can be mapped as endpoints.
These methods must always be public and static in order for them to be mapped.
Everything else is considered private methods.

namespace SolutionName.Endpoints.Public.Articles;

[Endpoint]
public static class GetByIdEndpoint {
  
  public static async Task<Article> Get(
    [FromRoute] int Id,
    [FromServices] DataContext context,
    CancellationToken cancellationToken) 
  {
  
    var article = await context.Articles.FirstAsync(article => article.Id == Id, cancellationToken);
  
    return article;
  }
}

Folder structure

One of the intentions for VerticalApi is to simplify folder structures and assist in making it easier to create a simple edition of vertical slicing.
Below is an example of how a folder structure could be set up.

  SolutionName
    - Endpoints
      - Public
        - Articles
          - GetById
            | GetById.cs
            - Dtos
              | GetByIdResponse.cs
            - Tests
              | GetByIdTest.cs

The structure allows for segmentation of the endpoint logic from the DTOs, Mappers, Helpers and other logic that ties in closely to the endpoint.

Product Compatible and additional computed target framework versions.
.NET 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
2025.1.8.175842 126 1/8/2025
2025.1.6.125359 114 1/6/2025
2024.12.23.171334 124 12/23/2024
2024.12.23.164154 116 12/23/2024
2024.12.23.141221 107 12/23/2024
2024.12.18.143611 131 12/18/2024
2024.12.18.130833 122 12/18/2024
2024.12.9.170246 116 12/9/2024
2024.12.8.170321 115 12/8/2024
2024.12.7.222746 117 12/7/2024
2024.12.7.191425 126 12/7/2024
2024.12.7.110147 129 12/7/2024
2024.12.3.214123 118 12/3/2024
2023.11.14.1420 224 11/14/2023
2023.11.13.235409 157 11/13/2023
2023.11.13.234435 157 11/13/2023
2023.11.13.232646 159 11/13/2023
2023.11.13.204258 148 11/13/2023
2023.5.12.124206 2,118 5/12/2023
2023.5.10.133233 230 5/10/2023
2023.5.10.121207 204 5/10/2023
2023.3.13.232329 556 3/13/2023
2023.3.13.231248 262 3/13/2023
2023.3.13.225321 272 3/13/2023
2023.1.12.131146 1,628 1/12/2023
2022.12.20.190400 354 12/20/2022
2022.11.27.173018 409 11/27/2022
2022.11.27.172008 388 11/27/2022
2022.11.27.170711 385 11/27/2022
2022.11.27.165443 377 11/27/2022
2022.11.26.153242 377 11/26/2022
2022.6.10.233509 2,133 6/10/2022
2022.6.10.222549 476 6/10/2022
2022.3.18.162630 505 3/18/2022