A equipe de análise e desenvolvimento de sistemas do TJRN está implementando uma nova Application Programming Interface (API) com o apoio de ferramentas Swagger. Para explorar a especificação da API de forma visual, a equipe utiliza a ferramenta Swagger, que é capaz de gerar, no próprio navegador web, a documentação visual da API, diretamente do documento de especificação. No entanto, a ferramenta utilizada não permite alterar o documento de especificação. Para explorar visualmente a especificação da API, a equipe utiliza a ferramenta Swagger:
- A)UI;
Correta: a Swagger UI gera a visualização interativa da documentação da API no navegador, sem editar o arquivo de especificação.
- B)Core;
Errada: o Swagger Core é o conjunto base de bibliotecas para manipular a especificação, não a interface visual para consulta.
- C)Parser;
Errada: o Parser serve para interpretar e ler a especificação, não para exibi-la como documentação navegável.
- D)Codegen;
Errada: o Codegen é voltado para gerar código a partir da especificação, não para visualizar a API.
- E)Inspector.
Errada: Inspector não é a ferramenta indicada para a documentação visual no navegador a partir da especificação.
Gabarito: A
Quando a questão fala em explorar a especificação da API de forma visual, diretamente no navegador, ela está descrevendo a Swagger UI. Essa ferramenta lê o documento de especificação da API, normalmente em OpenAPI/Swagger, e monta uma interface amigável para consultar endpoints, parâmetros, respostas e até testar chamadas sem sair do browser. O ponto mais importante aqui é este: a ferramenta mostra a documentação e permite interação, mas não altera o arquivo de especificação. Ela funciona como uma vitrine inteligente da API, não como um editor do contrato. Por isso, se a banca diz que a equipe quer apenas visualizar a especificação, a palavra-chave é UI, de interface. Já o núcleo do ecossistema Swagger, em sentido mais técnico, costuma envolver componentes como parsing, geração de código e processamento da especificação. Esses módulos têm funções mais internas e estruturais. A questão, porém, não pede geração nem leitura bruta do documento, e sim a exibição visual no navegador. Então o gabarito A está correto porque a Swagger UI é justamente a ferramenta usada para apresentar a documentação da API de forma visual e navegável, a partir da especificação existente. Em provas, sempre desconfie quando aparecer a ideia de 'visualizar no navegador' e 'sem alterar o documento': isso costuma apontar para a interface de documentação.