Skip to main content

Performance API Documentation

Summary​

Complete Draft API documentation for the source-backed Performance native, reporting, diagnostic, Workflow, and compatibility HTTP surfaces.

Audience​

API consumers, engineers, architects, QA, support, security reviewers, implementation partners, and product owners.

Overview​

Performance uses ASP.NET Core 8 minimal APIs rather than Controllers. Source maps 23 native operations and four compatibility operations. The API is Transitional because Gateway cutover and legacy-shaped routes coexist with native routes, and authentication is registered without endpoint authorization requirements.

This section records route families, methods, source DTO names, response shapes, validation, error mapping, testing evidence, and limitations without publishing sensitive appraisal examples or environment-specific values.

Documentation map​

Requires confirmation​

Endpoint authorization, permissions, ownership rules, callback authentication, diagnostic exposure, response redaction, API versioning, Gateway cutover, compatibility retirement, and contract ownership require confirmation.

Source References​

  • microservices/src/performance-service/Program.cs
  • microservices/src/performance-service/Api/PerformanceEndpoints.cs
  • microservices/src/performance-service/Api/PerformanceCompatEndpoints.cs
  • microservices/src/performance-service/Api/EndpointResults.cs
  • microservices/src/performance-service/Application/Dtos.cs
  • microservices/src/performance-service/Application/Compatibility/PerformanceCompatContracts.cs
  • microservices/src/gateway-api/Program.cs
  • microservices/scripts/smoke-performance.ps1

See Also​

Keywords​

  • Performance API
  • Minimal API
  • API documentation

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-16
  • Review cycle: Quarterly