> For the complete documentation index, see [llms.txt](https://framework.aic.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://framework.aic.io/technical-guidelines-code-standards-and-tech-stack/asp.net-core-web-api-standards.md).

# ASP.NET Core Web API Standards

## Purpose

This section defines the AIC standard for ASP.NET Core Web APIs.

It covers API design, contracts, security, documentation, performance and operational readiness.

## What This Section Covers

* API design, routing and models
* validation, error handling and idempotency
* authentication, authorization and OpenAPI
* health checks, performance and API testing

## Use This Section When

Use this section when:

* designing a new API
* reviewing endpoint behaviour
* setting API delivery and assurance rules