Информация об изменениях

Сообщение OpenAPI 3: почему не работает композиция от 20.07.2020 10:47

Изменено 20.07.2020 11:06 RonWilson

OpenAPI 3:почему не работает композиция
Привет,
пытаюсь пощупать OpenAPI и никак не пойму почему у меня не срабатывает композиция для такого элементарного примера:

Файл main.yml
openapi: 3.0.0
info:
  version: "1.0-oas3"
  title: "Web"
  description: "Web"
servers:
  - url: "https://test.ru/v1"
components:
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
  schemas:
    applicationNonAppearance: 
      $ref: "applications/applicationNonAppearance.yml"
paths:
  /kp/application/non-appearance:
    post:
      description:
        Оформление неявки сотрудника
      security:
        - BasicAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/applicationNonAppearance'
      responses:
        "200":
          description: "All OK"


файл applicationNonAppearance.yml:
allOf:
  - $ref: baseApplication.yml
    properties:
      documents:
        type: array
        description: "Документы по неявке"
        items:
          type: object
          properties:
            id:
              type: integer
              description: "Идентификатор прекрепленного документа по неявке"
              example: 35


файл baseApplication.yml:
baseApplication:
  type: object
  properties:
    employee:
      type: integer
      description: "Ключ работника"
      example: 88


в модели ожидаю, что будет employee и массив documents, но почему-то создается только document. Главное что и ошибок никаких не выдает — пробую в Visual Studio Code с плагином openapi-designer, показывающий справа превьюшку как и swagger editor, а может и его самого.

Чего не так-то?
OpenAPI 3: почему не работает композиция
Привет,
пытаюсь пощупать OpenAPI и никак не пойму почему у меня не срабатывает композиция для такого элементарного примера:

Файл main.yml
openapi: 3.0.0
info:
  version: "1.0-oas3"
  title: "Web"
  description: "Web"
servers:
  - url: "https://test.ru/v1"
components:
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
  schemas:
    applicationNonAppearance: 
      $ref: "applications/applicationNonAppearance.yml"
paths:
  /kp/application/non-appearance:
    post:
      description:
        Оформление неявки сотрудника
      security:
        - BasicAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/applicationNonAppearance'
      responses:
        "200":
          description: "All OK"


файл applicationNonAppearance.yml:
allOf:
  - $ref: baseApplication.yml
    properties:
      documents:
        type: array
        description: "Документы по неявке"
        items:
          type: object
          properties:
            id:
              type: integer
              description: "Идентификатор прекрепленного документа по неявке"
              example: 35


файл baseApplication.yml:
baseApplication:
  type: object
  properties:
    employee:
      type: integer
      description: "Ключ работника"
      example: 88


в модели ожидаю, что будет employee и массив documents, но почему-то создается только document. Главное что и ошибок никаких не выдает — пробую в Visual Studio Code с плагином openapi-designer, показывающий справа превьюшку как и swagger editor, а может и его самого.

Чего не так-то?
openapi swagger composition