21.02
topics · Web API 100

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