swagger-docs/storage.yml

openapi: 3.0.0
info:
  title: Sound storage as object
  version: 1.1.1
servers:
  - url: https://dev.k8s.tcloud.enginner/api/storage/v1
paths:
  /object:
    post:
      summary: Upload sound file for storage
      requestBody:
        content: 
          multipart/form-data:
            schema:
              type: object
              properties:
                description:
                  type: object
                  properties:
                    tag:
                      type: string
                soundFile:
                  type: string
                  format: binary
      responses:
        '200':
          description: Object successfully stored. This means that a get request for this object should be successful.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Success'
        '409':
          description: An object with this Tag already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'

  /object/{tag}:
    get:
      summary: Get a sound file from the storage
      parameters:
        - in: path
          name: tag
          schema:
            type: string
          required: true
          description: Tag of the sound file to get
      responses:
        '200':
          description: "The audio file requested"
          content:
            audio/wave:
             schema: 
               type: string
               format: binary
            
        '404':
          description: "Unknown tag error"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'

    delete:
      summary: Deletes a sound file from the storage
      parameters:
        - in: path
          name: tag
          schema:
            type: string
          required: true
          description: Tag of the sound file to delete
      responses:
        '200':
          description: "The audio file successfully deleted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Success'
            
        '404':
          description: "Unknown tag error"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Success:
      properties:
        status:
          type: string
          description: "Status message from backend."
      required:
        - status
    Error:
      properties:
        status:
          type: string
          description: "Status message from backend."
        msg:
          type: string
          description: "Human-readable description of the error"
      required:
        - status