FC ConcursosFC Concursos

Questão FC891016

Considere o seguinte trecho de uma descrição de API no padrão OpenAPI. openapi: 3.1.0 info: title: Exemplo version: 0.0.1] paths: /users/{id}: get: parameters: - name: id in: path

Web Services e APIs

Vunesp 2 · 2025

Considere o seguinte trecho de uma descrição de API no padrão OpenAPI.

 

openapi: 3.1.0

info:

  title: Exemplo

  version: 0.0.1]

paths:

  /users/{id}:

get:

  parameters:

   - name: id

     in: path 

     required: false

 

A respeito desse trecho de uma descrição de API no padrão OpenAPI, é correto afirmar que

  1. é inválido porque o valor de required deve ser true quando in tem o valor path.
  2. é inválido porque o trecho /{id} não deveria estar presente na sexta linha.
  3. é inválido porque get, que corresponde a um método HTTP, deveria estar grafado em letras maiúsculas.
  4. é válido.
  5. é inválido porque a barra (/) antes de users/{id} não deveria existir.
Mostrar resposta e comentário

Gabarito

A

Comentário do professor

No padrão OpenAPI, um parâmetro declarado com in: path representa um segmento obrigatório da URI. Isso ocorre porque a própria rota contém o marcador entre chaves (por exemplo, /users/{id}), logo o valor deve estar presente na requisição.

Por essa razão a especificação exige que o atributo required seja true para parâmetros de caminho. Declarar required: false para um parâmetro com in: path torna a descrição inválida.

Na prática, a correção é simples: ajustar o parâmetro para required: true, garantindo conformidade com o OpenAPI e que o identificador presente na rota seja sempre fornecido pelo cliente.

Conteúdo do catálogo FC Concursos · Atualizado em

Continue aprendendo