update the swagger document #2

ausdigital · Apr 26, 2017 · 6ef46ce · 6ef46ce
1 parent 528569c
commit 6ef46ce
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 8 deletions.
diff --git a/docs/2.0/api.md b/docs/2.0/api.md
@@ -1,4 +1,8 @@
 ---
 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,12 +27,11 @@
       "description":"Any TAP URL.",
       "required":true,
       "type":"string",
-      "default":""
     },
     "message":{
       "name":"message",
       "in":"formData",
-      "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",
+      "description":"The message file. Must be a valid json document. Shema - https://github.com/ausdigital/ausdigital-tap/blob/master/docs/2.0/schema.json",
       "required":true,
       "type":"file"
     },
@@ -60,24 +59,36 @@
       "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}"
       }
     }
   },
@@ -152,7 +163,7 @@
   },
   "definitions":{
     "TAPMessageData":{
-      "description":"TODO",
+      "description":"The response to post a TAP message request.",
       "properties":{
         "data":{
           "$ref":"#/definitions/TAPMessage"
@@ -200,15 +211,15 @@
             },
             "docId":{
               "type":"string",
-              "description":"The"
+              "description":"The Document Identifier"
             },
             "isRead":{
               "type":"boolean",
-              "description":"TODO"
+              "description":"The flag to indicate if a message is read."
             },
             "metadata":{
               "type":"object",
-              "description":"TODO"
+              "description":"The additional metadata."
             }
           }
         }
@@ -226,7 +237,7 @@
       }
     },
     "error":{
-      "description":"standard error response srtucture",
+      "description":"The standard error response definition.",
       "properties":{
         "code":{
           "type":"string",