swagger.yml

swagger: "2.0"
info:
  version: "1.0.0"
  title: Quick Demo
host: localhost
basePath: /quickdemo
schemes:
  - http
paths:
  /user:
    post:
      tags:
        - user
      summary: Create user
      parameters:
        - in: body
          name: user
          description: Created user object
          required: true
          schema:
            $ref: "#/definitions/item"
      responses:
        200:
          description: successful operation
        400:
          description: unsuccessful update
        600:
          description: couldn't establish connection to database
  /user/{id}:
    get:
      tags:
        - user
      summary: get user by id
      parameters:
        - $ref: "#/parameters/id"
      responses:
        200:
          description: successful operation
        401:
          description: user id not found
        600:
          description: couldn't establish connection to database
    delete:
      tags:
        - user
      summary: delete a user by Id
      parameters:
        - $ref: "#/parameters/id"
      responses:
        200:
          description: successful operation
        401:
          description: user id not found
        600:
          description: couldn't establish connection to database
    put:
      tags:
        - user
      summary: Update user
      parameters:
        - $ref: "#/parameters/id"
        - $ref: "#/parameters/user"
      responses:
        200:
          description: successful operation
        400:
          description: unsuccessful update
        600:
          description: couldn't establish connection to database
parameters:
  id:
    in: path
    name: id
    required: true
    type: string
  user:
    in: body
    name: user
    description: Created user object
    required: true
    schema:
      $ref: "#/definitions/item"
definitions:
  item:
    type: object
    required: [username, email]
    properties:
      username:
        type: string
        minLength: 4
        maxLength: 8
        pattern: /^[a-zA-Z][0-9a-zA-Z_\-]+$/
      firstName:
        type: string
      lastName:
        type: string
      email:
        type: array
        items:
          type: object
          required: [address, primary]
          minItems: 1
          maxItems: 6
          uniqueItems: true
          properties:
            address:
              type: string
              format: email
            primary:
              type: boolean