openapi: '3.0.3'
info:
  title: exam-api
  description: API for exam
  termsOfService: 'http://localhost:100/hello'
  version: '1.0'
servers:
  - url: http://localhost:100
paths:
  /hello:
    get:
      responses:
        '200':
          description: OK
  /api/v1/positions:
    get:
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: "./components.yaml#/components/schemas/position"
      description: Get all positions
    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"