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