json_schema: {
      "$schema": "http://json-schema.org/draft-04/schema#",
      "definitions": {
          "developer": {
              "type": "object",
              "properties": {
                  "shortCode": {
                      "type": "string",
                      "description": "the developer's shortcode"
                  },
                  "name": {
                      "type": "string",
                      "description": "the developer's name"
                  },
                  "blurb": {
                      "type": "string",
                      "description": "the developer's blurb"
                  },
                  "description": {
                      "type": "string",
                      "description": "the developer's description"
                  }
              },
              "additionalProperties": false,
              "required": [
                  "shortCode",
                  "name",
                  "blurb"
              ]
          }
      },
      "type": "object",
      "description": "details about a specific app",
      "additionalProperties": false,
      "properties": {
          "shortCode": {
              "type": "string",
              "description": "the app's shortcode"
          },
          "name": {
              "type": "string",
              "description": "the app's name"
          },
          "blurb": {
              "type": "string",
              "description": "the app's blurb"
          },
          "description": {
              "type": "string",
              "description": "the app's description"
          },
          "logoUrl": {
              "type": "string",
              "format": "url",
              "description": "the app's logo"
          },
          "learnMoreUrl": {
              "type": "string",
              "description": "the app's learnMoreUrl"
          },
          "principalType": {
              "type": "string",
              "description": "the app's principal type (if it is SSO)"
          },
          "developer": {
              "$ref": "#/definitions/developer"
          }
      },
      "required": [
          "shortCode",
          "name",
          "blurb",
          "developer"
      ]
  }