consumes:
    - application/json
info:
    title: Mlss Cc A
    version: 0.1.0
    description: A Swagger Example
produces:
    - application/json
schemes:
    - http
swagger: "2.0"

paths:
    /:
        get:
            tags:
                - alarms
            operationId: getAlarms
            parameters:
                - name: since
                  in: query
                  type: integer
                  format: int64
                - name: limit
                  in: query
                  type: integer
                  format: int32
                  default: 20
            responses:
                200:
                    description: list of alarm operations
                    schema:
                        type: array
                        items:
                            $ref: "#/definitions/item"
                default:
                    description: generic error response
                    schema:
                        $ref: "#/definitions/error"
        post:
            tags:
                - alarms
            operationId: addAlarm
            parameters:
                - name: body
                  in: body
                  schema:
                      $ref: "#/definitions/item"
            responses:
                201:
                    description: Created
                    schema:
                        $ref: "#/definitions/item"
                default:
                    description: error
                    schema:
                        $ref: "#/definitions/error"
    /{id}:
        parameters:
            - type: integer
              format: int64
              name: id
              in: path
              required: true
        put:
            tags:
                - alarms
            operationId: updateAlarm
            parameters:
                - name: body
                  in: body
                  schema:
                      $ref: "#/definitions/item"
            responses:
                '200':
                    description: OK
                    schema:
                        $ref: "#/definitions/item"
                default:
                    description: error
                    schema:
                        $ref: "#/definitions/error"
        delete:
            tags:
                - alarms
            operationId: deleteAlarm
            parameters:
                - type: integer
                  format: int64
                  name: id
                  in: path
                  required: true
            responses:
                204:
                    description: Deleted
                default:
                    description: error
                    schema:
                        $ref: "#/definitions/error"

    /person:
        get:
            tags:
                - person
            summary: persons i d u q
            description: persons insert delete update query
            operationId: getPersonList
            produces:
                - application/json
            parameters:
                - type: integer
                  format: int64
                  name: Id
                  in: query
                  required: true
            responses:
                200:
                    description: success
                    schema:
                        $ref: "#/definitions/PersonList"

definitions:
    item:
        type: object
        required:
            - description
        properties:
            id:
                type: integer
                format: int64
                readOnly: true
            description:
                type: string
                minLength: 1
            completed:
                type: boolean
    error:
        type: object
        required:
            - message
        properties:
            code:
                type: integer
                format: int64
            message:
                type: string
    Person:
        type: object
        properties:
            id:
                type: integer
                format: int64
                description: Id
                x-omitempty: false
            name:
                type: string
                x-omitempty: false
                description: 姓名
            code:
                type: string
                x-omitempty: false
                description: 编码
            phone:
                type: string
                x-omitempty: false
                description: 手机号码
            birth:
                type: string
                x-omitempty: false
                description: 时间
            email:
                type: string
                x-omitempty: false
                description: 邮箱
    PersonList:
        type: object
        properties:
            list:
                type: array
                x-omitempty: false
                items:
                    $ref: "#/definitions/Person"