Operacional
Endpoints fora do versionamento de features — probes e introspecção.
| Endpoint | Auth | O que é |
|---|---|---|
GET /health | anônimo | liveness probe |
GET /openapi/v1.json | Development | documento OpenAPI 3.1 gerado |
GET /scalar/v1 | Development | Scalar UI navegável |
GET /.well-known/jwks.json | anônimo | chaves públicas para validação de JWT |
Notas
- Probes de health são isentos de rate limiting (
DisableRateLimiting) — orquestradores os chamam várias vezes por segundo. - Endpoints operacionais não são versionados — probes não devem quebrar entre revisões da API.
- O fallback do SPA nunca captura
/v1,/health,/.well-known,/openapi,/scalar— rotas desconhecidas sob esses prefixos respondem404, não HTML. - O spec OpenAPI é commitado no repo (
src/{Projeto}.Spa/openapi/v1.json) e alimenta o codegen do client tipado do SPA; este site serve a cópia do canon em/openapi/v1.json.