# 21.02 Web API 100: topics

## Introduction to HTTP As an Application Layer Protocol

- Service Relationships Explained
- The HTTP "Constraints" And How They Guide Our Design
- The Three Parts of API Design: Resources, Representation, HTTP Methods
- Designing Evolvable APIs

## Implementing HTTP Resources in ASP.NET

- The ASP.NET Core Runtime and Configuration
- Using Controllers to Provide HTTP Resources
- Using "Minimal APIs" to Provide HTTP Resources
- Comparing Controllers and Minimal APIs
- Providing Services to your API Endpoints - Dependency Injection and Service Lifetime
- The Importance and Proper Use of `async/await` for Backing Services
- Accessing Request State: Headers, Cookies, Route Parameters, Query Strings
- Processing and Validating Request Entities
- Documenting Your API with The OpenAPI Specification (a.k.a. "Swagger")
- Caching: Object Caching and HTTP Response Caching with `Cache-Control` Headers
- Performing RPC Communication with Backing Services (Other APIs) using the HTTP Client
- Providing Resiliency For API Calls

## Implement Authentication and Authorization For Your API

- Understanding the Foundations of OpenID Connect (OIDC) and OAuth2
- Differentiating Authentication and Authorization
- Creating Authorization Policies
- Testing Your Authentication and Authorization
- Using the HTTP "Store" Archetype To Mirror Client State at the Server

## Introduction to the Developer Testing of APIs

- Writing Low-Level Unit Tests For Your API
- Writing Low-Level Unit Integration Tests for Your API
- Writing System Tests for Your API
- Stubbing and Mocking Dependencies
- Isolating Your Unit Integration and System Tests From Backing Services
  - Development Databases
  - Mocking HTTP Requests and Responses
