{ "swagger": "2.0", "info": { "title": "Item API", "description": "Item API", "version": "1.0.0" }, "host": "item.api.local", "basePath": "/v1", "securityDefinitions": { "key": { "type": "apiKey", "name": "x-item-token", "in": "header" } }, "security": [ { "key": [] } ], "consumes": [ "application/json" ], "produces": [ "application/json" ], "schemes": [ "http" ], "paths": { "/item": { "get": { "operationId": "GetItem", "responses": { "200": { "description": "item detail response", "schema": { "$ref": "#/definitions/myItems" } } } } } }, "definitions": { "myItems": { "$ref": "item.json#/item" } } }