Configuração
A UI não tem configuração em build-time: ela resolve o spec para renderizar inteiramente em runtime, via uma regra com um override.
Uma regra, um override
| Source | When | Example |
|---|---|---|
GET /api-json | Default: casa com o que SwaggerModule.setup() do @nestjs/swagger expõe ao lado do Swagger UI | https://api.example.com/docs → fetches https://api.example.com/api-json |
?spec=<url> | Query param: tem precedência sobre o default quando presente | https://docs.example.com/?spec=https://api.example.com/api-json |
CORS em origins diferentes
Se a UI é servida em uma origin diferente da API, use o override ?spec= e garanta que a configuração de CORS da API permita que essa origin faça GET no documento JSON.