Revert "update the swagger document #2"

This reverts commit 6ef46ce.
ausdigital · Apr 26, 2017 · aaaf9d3 · aaaf9d3
1 parent 6ef46ce
commit aaaf9d3
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 23 deletions.
diff --git a/docs/2.0/api.md b/docs/2.0/api.md
@@ -1,8 +1,4 @@
 ---
 layout: swagger
 data: ausdigital-tap_2-0_swagger
----
-
-Click [here](agilo.html){:target="_blank"} to see this specification in Agilo format with complete set of examples/models.
-
-Click [here](swagger.json){:target="_blank"} to download the original swagger document.
+---
diff --git a/docs/2.0/swagger.json b/docs/2.0/swagger.json
@@ -27,11 +27,12 @@
       "description":"Any TAP URL.",
       "required":true,
       "type":"string",
+      "default":""
     },
     "message":{
       "name":"message",
       "in":"formData",
-      "description":"The message file. Must be a valid json document. Shema - https://github.com/ausdigital/ausdigital-tap/blob/master/docs/2.0/schema.json",
+      "description":"The message file. Must be a valid json document. <span class=\"show-swagger-parameters-example\">Example</span>. Shema - https://github.com/ausdigital/ausdigital-tap/blob/master/docs/2.0/schema.json",
       "required":true,
       "type":"file"
     },
@@ -59,36 +60,24 @@
       "description":"The origin server did not find a current representation of the target resource or is not willing to disclose that one exists.",
       "schema":{
         "$ref":"#/definitions/errors"
-      },
-      "examples":{
-        "application/json":"{\n  \"errors\": [{\n      \"code\": \"TAP-0001\",\n      \"name\": \"Resource Not Found.\",\n      \"userMessage\": \"The origin server did not find a current representation of the target resource or is not willing to disclose that one exists.\"\n    }\n  ]\n}"
       }
     },
     "415":{
       "description":"Unsupported media type.",
       "schema":{
         "$ref":"#/definitions/errors"
-      },
-      "examples":{
-        "application/json":"{\n  \"errors\": [{\n      \"code\": \"TAP-0002\",\n      \"name\": \"Unsupported media type.\",\n      \"userMessage\": \"The origin server is refusing to service the request because the payload is in a format not supported by this method on the target resource.\"\n    }\n  ]\n}"
       }
     },
     "500":{
       "description":"Internal server error; no action required; may help to retry request later or contact support.",
       "schema":{
         "$ref":"#/definitions/errors"
-      },
-      "examples":{
-        "application/json":"{\n  \"errors\": [{\n      \"code\": \"TAP-0003\",\n      \"name\": \"Internal server error.\",\n      \"userMessage\": \"The server encountered an unexpected condition that prevented it from fulfilling the request.\"\n    }\n  ]\n}"
       }
     },
     "400-nofile":{
       "description":"The server cannot or will not process the request due to something that is perceived to be a client error.",
       "schema":{
         "$ref":"#/definitions/errors"
-      },
-      "examples":{
-        "application/json":"{\n  \"errors\": [{\n      \"code\": \"TAP-0004\",\n      \"name\": \"Bad Request.\",\n      \"userMessage\": \"The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).\"\n    }\n  ]\n}"
       }
     }
   },
@@ -163,7 +152,7 @@
   },
   "definitions":{
     "TAPMessageData":{
-      "description":"The response to post a TAP message request.",
+      "description":"TODO",
       "properties":{
         "data":{
           "$ref":"#/definitions/TAPMessage"
@@ -211,15 +200,15 @@
             },
             "docId":{
               "type":"string",
-              "description":"The Document Identifier"
+              "description":"The"
             },
             "isRead":{
               "type":"boolean",
-              "description":"The flag to indicate if a message is read."
+              "description":"TODO"
             },
             "metadata":{
               "type":"object",
-              "description":"The additional metadata."
+              "description":"TODO"
             }
           }
         }
@@ -237,7 +226,7 @@
       }
     },
     "error":{
-      "description":"The standard error response definition.",
+      "description":"standard error response srtucture",
       "properties":{
         "code":{
           "type":"string",