swagger-docs/input.yml

openapi: 3.0.0
info:
  title: Input endpoint of system
  version: 1.0.1
servers:
  - url: https://dev.k8s.tcloud.enginner/api/input/v1
paths:
  /sample:
    post:
      summary: Upload sound file into the system
      requestBody:
        content: 
          multipart/form-data:
            schema:
              type: object
              properties:
                description:
                  type: object
                  properties:
                    date:
                      type: string
                      format: date
                    device_id:
                      type: string
                soundFile:
                  type: string
                  format: binary
      responses:
        '200':
          description: OK Message
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OK'
        '416':
          description: Media type error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Error'
        '400':
          description: JSON parse error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Error'
        '444':
          description: JSON invalid schema
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Error'

components:
  schemas:
    OK:
      properties:
        status:
          type: string
          description: "Status message from backend."
      required:
        - status
    Error:
      properties:
        status:
          type: string
          description: "Status message from backend."
        message:
          type: string
          description: "Error message"
      required:
        - status
        - message