library-example-with-ext.json

{
    "swagger": "2.0",
    "info": {
      "title": "Google Example Library API",
      "description": "A simple Google Example Library API.",
      "version": "v1"
    },
    "host": "library-example.googleapis.com",
    
    "x-sampleone-book" : {"code": 123, "message": 999},
    "x-sampleone-shelf" : {"foo1": 123, "bar": 999},

    "x-sampleone-mysimplestring" : "hello world",
    "x-sampleone-mysimpleint64" : 12345,
    "x-sampleone-mysimplenumber" : 111.222,
    "x-sampleone-mysimpleboolean" : true,
    
    "x-sampletwo-book" : {"code": 123, "message": 999},
    "x-sampletwo-shelf" : {"foo1": 123, "bar": 999},

    "x-unhandled" : {"code": 123, "message": 999},

    "parameters" : {
      "paramAtSwaggerScope": {
        "name": "paramAtSwaggerScope",
        "in": "query",
        "description": "test",
        "required": true,
        "type": "integer",
        "format": "int32"
     }
    },
     "paths": {
        "/v1/{sharedParameter}/pets": {
            "post": {
                "operationId": "simpleMethod",
                "parameters": [
                    {
                        "name": "myBodyRef",
                        "in": "body",
                          "schema": {
                              "properties": {
                                  "myStringA": {
                                      "type": "string"
                                  }
                              }
                          }
                    },
                    {
                      "name": "paramToOverride",
                      "in": "query",
                      "description": "New description",
                      "required": true,
                      "type": "string"
                    },
                    {
                      "$ref": "#/parameters/paramAtSwaggerScope"
                    }
                ],
                "responses": {
                    "default": {
                        "description": "successful operation",
                        "schema": {
                                "$ref": "#/definitions/SimpleDef"
                        }
                    }
                }
            },
            "parameters": [
              {
                "name": "sharedParameter",
                "in": "path",
                "description": "Shared parameter",
                "required": true,
                "type": "string"
              },
              {
                "name": "paramToOverride",
                "in": "query",
                "description": "Description to override",
                "required": true,
                "type": "string"
              }
            ]
        }
    },
    "definitions": {
        "SimpleDef": {
            "properties": {
                "myStringA": {
                    "type": "string"
                }
            }
        },
        "SimpleDefWithBoolean": {
            "properties": {
                "active": {
                    "type": "boolean"
                }
            }
        }
    }
}