Example of https://github.com/r7kamura/rack-json_schema/

schema.yml

$schema: http://json-schema.org/draft-04/hyper-schema
title: The great new API
description: blah blah blah
properties:
  app:
    title: The application resource
    type: object
    properties:
      id:
        format: uuid
        example: 550e8400-e29b-41d4-a716-446655440000
        readonly: true
        type:  string
    links:
      -
        title: GET /apps
        description: List of apps
        method: GET
        href: /apps
        rel: instances


links:
  -
    href: http://localhost/
    rel: self