exam/main/api-swagger/paths/api.v1.positions.yaml

paths:
  api.v1.positions:
    get:
      summary: |-
        repo.findByOrganization()
      description: |-
        __Возвращает перечень должностей по организации__
        - можно получить из объекта Page

        Для разных организаций должности могут повторяться.
        - Не отправляет параметры с запросом.
      parameters:
        - name: id
          in: query
          required: false
          schema:
            type: integer
            format: int64
          default: 154
      responses:
        '200':
          description: Получение списка должностей
          content:
            application/json:
              schema:
                type: array
                $ref: "../components.yaml#/components/schemas/position"
        400:
          description: не верные параметры запроса
    post:
      summary: repo.create() Создает в базе запись о новой должности
      description: Предварительно должна существовать организация. Должность привязываетс для каждой организации, для разных организаций должности могут повторяться.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - organization
              properties:
                name:
                  type: string
                organization:
                  type: object
                  properties:
                    id:
                      type: integer
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: "../components.yaml#/components/schemas/position"