api.yaml

swagger: '2.0'

info:
  title: Tank Validator
  version: "0.3.0"
  description: Validates tank configs


basePath: /

paths:
  /config/validate:
    post:
      operationId: api.validate_config
      # summary: returns list of validation errors
      consumes:
        - multipart-form/file
        - multipart/form-data
      parameters:
        - name: config
          in: formData
          type: file
          required: true
        - name: fmt
          in: query
          required: true
          type: string
          enum:
            - ini
            - yaml
      responses:
        '200':
          description: validation info
          schema:
            type: object
            properties:
              config:
                type: object
                description: resulting config (accounting local tank configuration)
              errors:
                type: array
                items:
                  type: object
  /config/validate.json:
    post:
      operationId: api.validate_config_json
      # summary: returns list of validation errors
      # consumes: ""
      parameters:
        - name: config
          in: body
          required: true
          schema:
            type: object
      consumes:
        - application/json
      responses:
        '200':
          description: validation info
          schema:
            type: object
            properties:
              config:
                type: object
                description: resulting config (accounting local tank configuration)
              errors:
                type: array
                items:
                  type: object