Questão nº 27
Questão de Tecnologia da Informação · FCC TRT-12 2023 (nº 27)
Uma Analista está desenvolvendo uma API REST para um aplicativo e deseja criar a documentação usando o Swagger. Essa documentação é criada adequadamente através
- Ado Swagger Codegen, que permite a criação manual da especificação OpenAPI.
- Bda interface Swagger Editor, que permite criar a especificação OpenAPI interativamente. (alternativa correta)
- Cda elaboração de um arquivo de documentação PDF com o Swagger PDF Editor contendo a descrição das APIs.
- Dda interface Swagger GetJet, que cria e exibe automaticamente a documentação.
- Eda elaboração de um arquivo XML de forma manual, contendo a especificação OpenDocumentAPI.
Resposta comentada
Gabarito Alternativa B
A documentação de uma API REST usando Swagger/OpenAPI é uma descrição padronizada (geralmente em YAML ou JSON) de como a API funciona, permitindo que outros desenvolvedores a entendam e usem facilmente. Ela descreve os endpoints, métodos, parâmetros, modelos de dados e respostas da API.
- (A) Incorreta: O Swagger Codegen é uma ferramenta para gerar código (clientes, servidores, modelos) a partir de uma especificação OpenAPI já existente, e não para criar manualmente a especificação em si.
- (B) Correta: A interface Swagger Editor é uma ferramenta baseada em navegador que permite aos desenvolvedores escrever, validar e visualizar a especificação OpenAPI (a documentação) de forma interativa, facilitando sua criação.
- (C) Incorreta: Não existe um "Swagger PDF Editor" padrão para a criação da especificação OpenAPI. A documentação Swagger/OpenAPI é primariamente focada em formatos legíveis por máquina (YAML/JSON) e interfaces web interativas (Swagger UI), não PDFs como método de criação.
- (D) Incorreta: "Swagger GetJet" não é uma ferramenta reconhecida ou padrão no ecossistema Swagger/OpenAPI para criar ou exibir documentação automaticamente.
- (E) Incorreta: A especificação OpenAPI é escrita em YAML ou JSON, não em XML, e seu nome correto é OpenAPI Specification, não "OpenDocumentAPI".
Fonte: FCC TRT-12 2023 Analista Judiciário - Área Apoio Especializado - Especialidade Tecnologia da Informação (Caderno Tipo 003). Reproduzida para fins de estudo.