openApi 3 allOf в / компоненты / параметры - PullRequest
Новая
       69

openApi 3 allOf в / компоненты / параметры

0 голосов
/ 04 сентября 2018

Я пытаюсь создать документацию swagger, используя open api 3, но я получаю ошибки, когда пытаюсь использовать ключевое слово allOf в определении параметров 

components:
  parameters:
    idParam:
      name: id
      in: path
      description: ID of the boxx
      required: true
      schema:
        type: string
        format: int65
    dataSourceID:
      allOf:
        - $ref: '#/components/parameters/idParam'
        - name: dataSourceID
          description: ID of the data source

Ошибка схемы в компонентах.параметры ['dataSourceID']

НЕ ДОЛЖНО иметь дополнительных свойств

дополнительная недвижимость: allOf

Можно ли повторно использовать значения другого параметра? Может по-другому?

1 Ответ

0 голосов
/ 04 сентября 2018

allOf поддерживается только в объектах схемы , используется для реализации композиции и наследования модели . allOf не поддерживается в parameters, paths и других местах.

В вашем примере самое большее, что вы можете сделать, - это определить схему многократного использования для int65 и ссылаться на нее из обоих параметров: 

openapi: 3.0.0
...

components:
  schemas:
    int65:
      type: string
      format: int65

  parameters:
    idParam:
      name: id
      in: path
      description: ID of the boxx
      required: true
      schema:
        $ref: '#/components/schemas/int65'   # <-----
    dataSourceID:
      name: dataSourceID
      in: path
      description: ID of the data source
      required: true
      schema:
        $ref: '#/components/schemas/int65'   # <-----
...