Можно ли указать параметр, требуемый для одной конечной точки и необязательный, как другой в Openapi 3.0?

Question

Я использую Openapi 3.0 и пытаюсь создать параметр запроса, необходимый для одной конечной точки и необязательный для другой. Поскольку параметры теперь определяются с использованием схем, я не знаю, возможно ли это.

Answer 1

Да, это возможно - как в OpenAPI 3.0, так и в 2.0. В контексте параметров атрибут required является атрибутом уровня параметра, а не атрибутом схемы.

paths:
  /something:
    get:
      parameters:
        - in: query
          name: foo
          required: true  # <-----
          schema:
            type: string
      ...
  /something-else:
    get:
      parameters:
        - in: query
          name: foo
          required: false  # <----- Can be omitted because parameters are optional by default
          schema:
            type: string
      ...