todo-api-swagger

swagger: '2.0'
info:
  title: Todo API
  description: A simple API to manage your todo tasks.
  version: "1.0.0"
# the domain of the service
host: todo.bla.com
# array of all schemes that your API supports
schemes:
  - http
produces:
  - application/json
paths:
  /todoitems:
    get:
      summary: list todo items
      description: list todo items
      responses:
        200:
          description: todo
          schema: 
            $ref: '#/definitions/TodoItemsResponse'
        default:
          description: Internal server error
definitions:
  TodoItem:
    type: object
    properties:
      id:
        type: integer
        format: int64
        description: the id the this todo item
      name:
        type: string
        description: the name/title of the todo item
        maxLength: 140
      done:
        type: boolean
        description: if the item has been finished
      timestamp:
        type: string
        format: date-time
        description: when the item was created/updated 
  TodoItemsResponse:
    type: object
    properties:
      items:
        type: array
        items:
              $ref: '#/definitions/TodoItem'