Merge pull request #3 from fehguy/master

Simple 2.0 spec example

Author: fehguy

samples/v2.0/json/.gitkeep

@@ -0,0 +1,115 @@
+{
+  "swagger": 2.0,
+  "info": {
+    "version": "1.0.9-abcd",
+    "title": "Swagger Sample API",
+    "description": "A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification",
+    "termsOfService": "http://helloreverb.com/terms/",
+    "contact": "mailto://apiteam@wordnik.com",
+    "license": "Creative Commons 4.0 International",
+    "licenseUrl": "http://creativecommons.org/licenses/by/4.0/"
+  },
+  "host": "my.api.com",
+  "basePath": "/v1",
+  "resources": {
+    "schemes": [
+      "http",
+      "https"
+    ],
+    "produces": [
+      "application/json",
+      "application/xml"
+    ],
+    "/pets/{petId}": {
+      "get": {
+        "summary": "Find pet by ID",
+        "description": "Returns a pet based on ID",
+        "nickname": "getPetsById",
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/plain",
+          "text/html"
+        ],
+        "parameters": [
+          {
+            "name": "petId",
+            "kind": "path",
+            "summary": "ID of pet that needs to be fetched",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "csv"
+            }
+          },
+          {
+            "name": "verbose",
+            "kind": "query",
+            "description": "Expand the response and show extra data",
+            "required": false,
+            "type": "boolean"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": null,
+            "type": "Pet"
+          },
+          "400": {
+            "description": "Invalid ID supplied <= this is purely for documentation",
+            "type": "ErrorModel"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        }
+      }
+    }
+  },
+  "models": {
+    "Pet": {
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "tag": {
+          "$ref": "Tag"
+        }
+      }
+    },
+    "Tag": {
+      "required": [
+        "id",
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "id": {
+          "type": "integer",
+          "format": "int64"
+        }
+      }
+    },
+    "ErrorModel": {
+      "required": [
+        "code",
+        "message"
+      ],
+      "properties": {
+        "code": {
+          "type": "integer",
+          "format": "int32"
+        },
+        "message": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}