json_schema: {
      "definitions": {
          "sock": {
              "$schema": "http://json-schema.org/draft-04/schema",
              "definitions": {
                  "body": {
                      "description": "body describing of the sock",
                      "readOnly": true,
                      "type": [
                          "string"
                      ]
                  },
                  "id": {
                      "description": "unique identifier of sock",
                      "format": "uuid",
                      "readOnly": true,
                      "type": [
                          "string"
                      ]
                  },
                  "identity": {
                      "allOf": [
                          {
                              "$ref": "#/definitions/sock/definitions/id"
                          }
                      ]
                  },
                  "latitude": {
                      "description": "latitude of sock coordinates",
                      "readOnly": true,
                      "type": [
                          "number"
                      ]
                  },
                  "longitude": {
                      "description": "longitude of sock coordinates",
                      "readOnly": true,
                      "type": [
                          "number"
                      ]
                  },
                  "title": {
                      "description": "title of the sock",
                      "readOnly": true,
                      "type": [
                          "string"
                      ]
                  }
              },
              "description": "Where socks go",
              "links": [
                  {
                      "description": "List existing socks.",
                      "href": "/api/socks",
                      "http_header": {
                          "Accept": "application/vnd.wheresocksgo+json; version=1"
                      },
                      "method": "GET",
                      "rel": "instances",
                      "title": "List"
                  }
              ],
              "properties": {
                  "body": {
                      "$ref": "#/definitions/sock/definitions/body"
                  },
                  "id": {
                      "$ref": "#/definitions/sock/definitions/id"
                  },
                  "latitude": {
                      "$ref": "#/definitions/sock/definitions/latitude"
                  },
                  "longitude": {
                      "$ref": "#/definitions/sock/definitions/longitude"
                  },
                  "title": {
                      "$ref": "#/definitions/sock/definitions/title"
                  }
              },
              "stability": "prototype",
              "strictProperties": true,
              "title": "Socks",
              "type": [
                  "object"
              ]
          }
      },
      "description": "Wheresocksgo API",
      "links": [
          {
              "href": "https://wheresocksgo.herokuapp.com",
              "rel": "self"
          }
      ],
      "properties": {
          "sock": {
              "$ref": "#/definitions/sock"
          }
      },
      "title": "Wheresocksgo",
      "type": [
          "object"
      ]
  }