Added missing docs and organized sample files (#97)
Co-authored-by: Adam Bem <adam.bem@zoho.eu> Reviewed-on: R11/release11-tools-web#97
This commit is contained in:
		@@ -30,6 +30,10 @@
 | 
			
		||||
    {
 | 
			
		||||
      "name": "Mocked services",
 | 
			
		||||
      "description": "Mocked services controller"
 | 
			
		||||
    },
 | 
			
		||||
    {
 | 
			
		||||
      "name": "XML Formatter",
 | 
			
		||||
      "description": "XML formatting API"
 | 
			
		||||
    }
 | 
			
		||||
  ],
 | 
			
		||||
  "paths": {
 | 
			
		||||
@@ -38,7 +42,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked events"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "filterHistory",
 | 
			
		||||
        "summary": "Filter History",
 | 
			
		||||
        "operationId": "filterHistoryUsingPOST",
 | 
			
		||||
        "consumes": [
 | 
			
		||||
          "application/json"
 | 
			
		||||
@@ -84,7 +88,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked events"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "getLastDay",
 | 
			
		||||
        "summary": "Get last day",
 | 
			
		||||
        "operationId": "getLastDayUsingGET",
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "*/*"
 | 
			
		||||
@@ -131,7 +135,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked services"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "updateMessage",
 | 
			
		||||
        "summary": "Update message",
 | 
			
		||||
        "operationId": "updateMessageUsingPUT",
 | 
			
		||||
        "consumes": [
 | 
			
		||||
          "application/json"
 | 
			
		||||
@@ -177,7 +181,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked services"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "getListOfMessages",
 | 
			
		||||
        "summary": "Get list of messages",
 | 
			
		||||
        "operationId": "getListOfMessagesUsingGET",
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "*/*"
 | 
			
		||||
@@ -218,7 +222,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked services"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "getMockedResponse",
 | 
			
		||||
        "summary": "Get response from mocked service",
 | 
			
		||||
        "operationId": "getMockedResponseUsingGET",
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "*/*"
 | 
			
		||||
@@ -300,7 +304,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked services"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "getListOfMessages",
 | 
			
		||||
        "summary": "Get list of messages",
 | 
			
		||||
        "operationId": "getListOfMessagesUsingGET_1",
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "*/*"
 | 
			
		||||
@@ -383,7 +387,7 @@
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "Mocked services"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "removeMessage",
 | 
			
		||||
        "summary": "Remove message",
 | 
			
		||||
        "operationId": "removeMessageUsingDELETE",
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "*/*"
 | 
			
		||||
@@ -645,6 +649,100 @@
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    },
 | 
			
		||||
    "/minimize": {
 | 
			
		||||
      "post": {
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "XML Formatter"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "Minimize given XML (only libxml)",
 | 
			
		||||
        "description": "Removes any unneeded whitespace from given xml file",
 | 
			
		||||
        "operationId": "minimize",
 | 
			
		||||
        "consumes": [
 | 
			
		||||
          "application/json"
 | 
			
		||||
        ],
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "application/json"
 | 
			
		||||
        ],
 | 
			
		||||
        "parameters": [
 | 
			
		||||
          {
 | 
			
		||||
            "in": "body",
 | 
			
		||||
            "name": "request",
 | 
			
		||||
            "description": "A XML to minimize",
 | 
			
		||||
            "required": true,
 | 
			
		||||
            "schema": {
 | 
			
		||||
              "$ref": "#/definitions/RequestPrettify"
 | 
			
		||||
            }
 | 
			
		||||
          }
 | 
			
		||||
        ],
 | 
			
		||||
        "responses": {
 | 
			
		||||
          "200": {
 | 
			
		||||
            "description": "successful operation",
 | 
			
		||||
            "schema": {
 | 
			
		||||
              "type": "array",
 | 
			
		||||
              "items": {
 | 
			
		||||
                "$ref": "#/definitions/MinimizedResponse"
 | 
			
		||||
              }
 | 
			
		||||
            }
 | 
			
		||||
          },
 | 
			
		||||
          "400": {
 | 
			
		||||
            "description": "Invalid status value",
 | 
			
		||||
            "schema": {
 | 
			
		||||
              "type": "array",
 | 
			
		||||
              "items": {
 | 
			
		||||
                "$ref": "#/definitions/XSDError"
 | 
			
		||||
              }
 | 
			
		||||
            }
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    },
 | 
			
		||||
    "/prettify": {
 | 
			
		||||
      "post": {
 | 
			
		||||
        "tags": [
 | 
			
		||||
          "XML Formatter"
 | 
			
		||||
        ],
 | 
			
		||||
        "summary": "Prettify given XML (only libxml)",
 | 
			
		||||
        "description": "Removes any unneeded whitespace from given xml file",
 | 
			
		||||
        "operationId": "minimize",
 | 
			
		||||
        "consumes": [
 | 
			
		||||
          "application/json"
 | 
			
		||||
        ],
 | 
			
		||||
        "produces": [
 | 
			
		||||
          "application/json"
 | 
			
		||||
        ],
 | 
			
		||||
        "parameters": [
 | 
			
		||||
          {
 | 
			
		||||
            "in": "body",
 | 
			
		||||
            "name": "request",
 | 
			
		||||
            "description": "A XML to prettify",
 | 
			
		||||
            "required": true,
 | 
			
		||||
            "schema": {
 | 
			
		||||
              "$ref": "#/definitions/RequestMinimize"
 | 
			
		||||
            }
 | 
			
		||||
          }
 | 
			
		||||
        ],
 | 
			
		||||
        "responses": {
 | 
			
		||||
          "200": {
 | 
			
		||||
            "description": "Successful operation",
 | 
			
		||||
            "schema": {
 | 
			
		||||
              "type": "array",
 | 
			
		||||
              "items": {
 | 
			
		||||
                "$ref": "#/definitions/MinimizedResponse"
 | 
			
		||||
              }
 | 
			
		||||
            }
 | 
			
		||||
          },
 | 
			
		||||
          "400": {
 | 
			
		||||
            "description": "Invalid status value",
 | 
			
		||||
            "schema": {
 | 
			
		||||
              "type": "array",
 | 
			
		||||
              "items": {
 | 
			
		||||
                "$ref": "#/definitions/XSDError"
 | 
			
		||||
              }
 | 
			
		||||
            }
 | 
			
		||||
          }
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  },
 | 
			
		||||
  "definitions": {
 | 
			
		||||
@@ -794,7 +892,7 @@
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "data": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": " Test1 Test3 ",
 | 
			
		||||
          "example": "<values><value>2</value><value>8</value></values>",
 | 
			
		||||
          "description": "The XML data to be processed"
 | 
			
		||||
        },
 | 
			
		||||
        "process": {
 | 
			
		||||
@@ -824,7 +922,7 @@
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "data": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": " Test1 Test3 ",
 | 
			
		||||
          "example": "<values><value>2</value><value>8</value></values>",
 | 
			
		||||
          "description": "The XML data to be processed"
 | 
			
		||||
        },
 | 
			
		||||
        "process": {
 | 
			
		||||
@@ -854,12 +952,12 @@
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "data": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "  Ola Nordmann Langgt 23 4000 Stavanger Norway  ",
 | 
			
		||||
          "example": "<values><value>2</value><value>8</value></values>",
 | 
			
		||||
          "description": "The XML data to be processed"
 | 
			
		||||
        },
 | 
			
		||||
        "process": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "  Ola Nordmann Langgt 23 4000 Stavanger Norway  ",
 | 
			
		||||
          "example": "<xs:schema xmlns:xs=\"http://www.w3.org/2001/XMLSchema\" xmlns=\"http://www.tibco.com/schemas/test/Test/Resources/Schema.xsd\" targetNamespace=\"http://www.tibco.com/schemas/test/Test/Resources/Schema.xsd\" elementFormDefault=\"qualified\" attributeFormDefault=\"unqualified\"> <xs:element name=\"values\"><xs:complexType><xs:sequence><xs:element name=\"value\" type=\"xs:string\" minOccurs=\"0\" maxOccurs=\"unbounded\"/></xs:sequence></xs:complexType></xs:element></xs:schema>",
 | 
			
		||||
          "description": "XSD to perform verification with"
 | 
			
		||||
        },
 | 
			
		||||
        "processor": {
 | 
			
		||||
@@ -896,7 +994,8 @@
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "Saxon 10.3 2.0 over s9api",
 | 
			
		||||
            "Xalan Java 2.7.2"
 | 
			
		||||
            "Xalan Java 2.7.2",
 | 
			
		||||
            "libXml over lxml"
 | 
			
		||||
          ]
 | 
			
		||||
        },
 | 
			
		||||
        "status": {
 | 
			
		||||
@@ -924,7 +1023,8 @@
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "Saxon 10.3 2.0 over s9api",
 | 
			
		||||
            "Xalan Java 2.7.2"
 | 
			
		||||
            "Xalan Java 2.7.2",
 | 
			
		||||
            "libXml over lxml"
 | 
			
		||||
          ]
 | 
			
		||||
        },
 | 
			
		||||
        "status": {
 | 
			
		||||
@@ -988,6 +1088,114 @@
 | 
			
		||||
          ]
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    },
 | 
			
		||||
    "RequestPrettify": {
 | 
			
		||||
      "type": "object",
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "data": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "<values><value>2</value><value>8</value></values>",
 | 
			
		||||
          "description": "The XML data to be prettified"
 | 
			
		||||
        },
 | 
			
		||||
        "process": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "",
 | 
			
		||||
          "description": "Unused here, required only to use same json for whole project"
 | 
			
		||||
        },
 | 
			
		||||
        "processor": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "libxml"
 | 
			
		||||
          ]
 | 
			
		||||
        },
 | 
			
		||||
        "version": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "1.0"
 | 
			
		||||
          ]
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    },
 | 
			
		||||
    "RequestMinimize": {
 | 
			
		||||
      "type": "object",
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "data": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "<values><value>2</value><value>8</value></values>",
 | 
			
		||||
          "description": "The XML data to be minimized"
 | 
			
		||||
        },
 | 
			
		||||
        "process": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "",
 | 
			
		||||
          "description": "Unused here, required only to use same json for whole project"
 | 
			
		||||
        },
 | 
			
		||||
        "processor": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "libxml"
 | 
			
		||||
          ]
 | 
			
		||||
        },
 | 
			
		||||
        "version": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "1.0"
 | 
			
		||||
          ]
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    },
 | 
			
		||||
    "PrettifiedResponse": {
 | 
			
		||||
      "type": "object",
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "result": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "<values>\\n\\t<value>2</value>\\n\\t<value>8</value>\\n</values>",
 | 
			
		||||
          "description": "Prettified XML"
 | 
			
		||||
        },
 | 
			
		||||
        "time": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "320",
 | 
			
		||||
          "description": "Computation time in milliseconds"
 | 
			
		||||
        },
 | 
			
		||||
        "processor": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "libXml over lxml"
 | 
			
		||||
          ]
 | 
			
		||||
        },
 | 
			
		||||
        "status": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "OK"
 | 
			
		||||
          ]
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    },
 | 
			
		||||
    "MinimizedResponse": {
 | 
			
		||||
      "type": "object",
 | 
			
		||||
      "properties": {
 | 
			
		||||
        "result": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "<values><value>2</value><value>8</value></values>",
 | 
			
		||||
          "description": "Result of minimized provided XML"
 | 
			
		||||
        },
 | 
			
		||||
        "time": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "example": "320",
 | 
			
		||||
          "description": "Computation time in milliseconds"
 | 
			
		||||
        },
 | 
			
		||||
        "processor": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "libXml over lxml"
 | 
			
		||||
          ]
 | 
			
		||||
        },
 | 
			
		||||
        "status": {
 | 
			
		||||
          "type": "string",
 | 
			
		||||
          "enum": [
 | 
			
		||||
            "OK"
 | 
			
		||||
          ]
 | 
			
		||||
        }
 | 
			
		||||
      }
 | 
			
		||||
    }
 | 
			
		||||
  },
 | 
			
		||||
  "externalDocs": {
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user