Блог

Можно определить параметр в разделе параметры, в разделе компоненты на листе OPEN API. В то же время можно ссылаться на этот параметр в пути в разделе ответов.

Что я хочу сделать, так это, например, если параметр «include» типа array переопределяет только перечисление раздела части схемы из раздела путей, ссылающегося на раздел компонентов.

Кажется, что директива allOf не разрешена в этом контексте, есть ли способ это сделать? Вероятно, мне просто нужен пример.

Пример:

В разделе components.parameters:

 - name: include
  in: query
  description: relationships to include
  type: array
  style: form
  explode: true
  schema: 
     type: array
     items:
        type: string
  

В разделе пути. .. параметры:

 - name: include
  in: query
  description: relationships to include
  type: array
  style: form
  explode: true
  schema: 
     type: array
     items:
        type: string
        enum: [legs, owner]           
  

Я хотел бы переопределить только раздел enum, а не