Update REST API documentation

Author: wborn

api/openapi.yaml

@@ -753,36 +753,18 @@ paths:
     get:
       tags:
       - Asset Model
-      summary: Retrieve the valueDescriptor JSON Schema.
+      summary: Retrieve the JSON Schema of the specified value descriptor
       operationId: getValueDescriptorSchema
       parameters:
-      - name: Authorization
-        in: header
-        schema:
-          type: string
-      - name: X-Forwarded-Proto
-        in: header
-        schema:
-          type: string
-      - name: X-Forwarded-Host
-        in: header
-        schema:
-          type: string
       - name: name
         in: query
         schema:
           type: string
-      - name: hash
-        in: query
-        schema:
-          type: string
       responses:
         "200":
           description: default response
           content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/JsonNode"
+            application/json: {}
   /model/valueDescriptors:
     get:
       tags:
@@ -1747,6 +1729,15 @@ paths:
         schema:
           type: integer
           format: int64
+      - name: format
+        in: query
+        schema:
+          type: string
+          default: CSV
+          enum:
+          - CSV
+          - CSV_CROSSTAB
+          - CSV_CROSSTAB_MINUTE
       responses:
         "200":
           description: default response
@@ -5722,8 +5713,6 @@ components:
           type: array
           items:
             type: string
-    JsonNode:
-      type: object
     UserAssetLink:
       type: object
       properties:
@@ -6853,6 +6842,8 @@ components:
           format: date-time
         acknowledgement:
           type: string
+    JsonNode:
+      type: object
     Notification:
       type: object
       properties:

docs/rest-api/get-datapoint-export.api.mdx

@@ -5,7 +5,7 @@ description: "Retrieve a datapoint export of an asset attribute"
 sidebar_label: "Retrieve a datapoint export of an asset attribute"
 hide_title: true
 hide_table_of_contents: true
-api: eJzNVU2P3DYM/SsCTy2gWIOk6MGnLtIgDZCii+3ktJgD16bHQiRRkejdbAb+74XkGWdnkH4kyKEnGxTfE8UnPh1AcJ+hvYWrnEnUrygY2QaBnQaOlFAshzc9tLAnWVdffYycBDRETOhJKBWOAwT0BC2gSLJ3k9ANDRk02AAtfJgoPYKG3I3kEdoDyGMs2VmSDXuYZ70SDIn91nrKgj7+K4ENQntKoGHg5FGW0M8/nVEKfxfCnYZEOXLIlAvi+WZTPj3lLtlYmgUt9DTg5ESdMkFDx0EoSMnFGJ3tamPNJxuhPczzPOsLjhuSZOmeFKr+1HZFte+KB4VBYVVs7TVo8CQjH7Wq4sgILZiaaFYWQyf1MqX7k3RTctDCKBJza0xPnhuOFBJ5FmosG4zWHBKh87MBDfeYLN65pQs1vPShnhxa8JiFEsy1ZZm6KVl5rDsVWttDe7t7uvRnEWFhOyWsejBOMj4vcjh+qCmdsxTkZaKeglh0NSj8nsK7eg5TEKaWlc1SiomJhTt2ZuF/1nEI1ImpMCi6Dony+O0EueO4nCAmHqwrpZ/+isCFkpP9VKV/yT3V2/A0+PV7l1TQ//Oj1+ttw8BVJSt1+Y9I4abeLvU7BtxTUr9tt9fq6voNXA7DdrRZ2axkJNVzN3kKUhumBk41+g9sjVLXjjCTykQ1+faMY/fDeuu5y+e3/se6gedEqtTfHCcZuzrJ5NG6ag4D/3KGg1mDsx2V4W9XD7p6ff1WvWg2oC/G7eHhodmHqeG0N0dYNriP7tmLZtNQaEbxrnCWcV1aUhY2JRQ5i8fwZJtvsY6zfq+DJ/RRTHRoQ9mp1nw42sotVJICXd8MDUdr2WkYOUvJOhzuMNO75Oa5hBfPLTbQ21z8o4d2QJdJw3t6/MLbcY9uKqVA8fK/wVw+F/8Fc/4efEbsPltbtSgNI2FPqda8QK+6jqI8QV06eiFZvfj1qy3M819ropg+
+api: eJzNVVFvGzcM/isCnzZAPRntsId7mucFXYB1DWKnL4FRKHc8n1BJ1CRe0tS4/15IZ19jY+2yYg97so8iP1Lkx097YL1LUN/CMiVk8ZtmHch4hq0EChg1G/KXLdSwQ55PLz4GigwSgo7aIWPMGHvw2iHUoJmjuRsYr7FLIMF4qOGvAeMjSEhNj05DvQd+DNk7cTR+B+MoZ4AuktsYh4m1C/8IYDzjDiNI6Cg6zZPp559OIJn+Y8DD0TNvJ6HFTg82Y63W70AC+sHlxk9fq/W796vrt+v1Zvnr2ef7N5d/3mwuYDuOWwkRUyCfMOUcLxeL/NNiaqIJeVRQHxOJoydIaMgzes6+OgRrmjJW9ckEqPfjOI7yDOMaORq8R6FFexy6wDJ1QZ3QXujCl3nSIMEh93RgSqEG91CDKo5qRlF45E7CeH8kzhAt1NAzh1Qr1aKjigL6iI4YK0NKB6P2EbV1owIJ9zoafWenLhTz1Idji51OjBHG0rKEzRANP5ZMGda0UN9unx6t89gmtKPDPEHSA/cvMxksPRSXxhr0vIrYomejbTEyfUB/U+6hcoQqZSU1laJCJKaGrJrwXzTkPTasShjkuXYRU//9AKmhMN0gROqMzaUf/+UBZ0iK5lMZ/YpaLGx4avz3ubMryP/51Qu9je+oTMlwOX4b0F8Xdok32usdRvH7ZnMllleXcL4Mm94kYZLgHkVLzeDQc2mY6CgW6zfQKiGuLOqEIiEW59sTjO0PM+upSaes/7EkcBRR5PqrwybrpmwyOm1skaaOfjmJg1GCNQ3m5a9nwVq+vvpDvKoWIM/W7eHhodr5oaK4U4ewpPQu2BevqkWFvurZ2YyZ13VqST5YZFOgxE77J2m+RzpO+j0vHuNHVsFq43OmUvP+ICu3UEBy6PxiSThIy1ZCT4mz135/pxPeRDuO2TypdJaB1qSsHy3UnbYJJXzAx795ue61HXIpkIX/KzHnj9VzYk5fo2dlOT43X5y3X3Sw6JmEHnWLsVxwilo2DYanUefyn0Fm4X59sYFx/AyG+82W
 sidebar_class_name: "get api-method"
 info_path: docs/rest-api/openremote-manager-http-api
 custom_edit_url: null
@@ -47,7 +47,7 @@ Retrieve a datapoint export of an asset attribute
 </Heading>
 
 <ParamsDetails
-  parameters={[{"name":"attributeRefs","in":"query","schema":{"type":"string"}},{"name":"fromTimestamp","in":"query","schema":{"type":"integer","format":"int64"}},{"name":"toTimestamp","in":"query","schema":{"type":"integer","format":"int64"}}]}
+  parameters={[{"name":"attributeRefs","in":"query","schema":{"type":"string"}},{"name":"fromTimestamp","in":"query","schema":{"type":"integer","format":"int64"}},{"name":"toTimestamp","in":"query","schema":{"type":"integer","format":"int64"}},{"name":"format","in":"query","schema":{"type":"string","default":"CSV","enum":["CSV","CSV_CROSSTAB","CSV_CROSSTAB_MINUTE"]}}]}
 >
 
 </ParamsDetails>

docs/rest-api/get-value-descriptor-schema.api.mdx

@@ -1,11 +1,11 @@
 ---
 id: get-value-descriptor-schema
-title: "Retrieve the valueDescriptor JSON Schema."
-description: "Retrieve the valueDescriptor JSON Schema."
-sidebar_label: "Retrieve the valueDescriptor JSON Schema."
+title: "Retrieve the JSON Schema of the specified value descriptor"
+description: "Retrieve the JSON Schema of the specified value descriptor"
+sidebar_label: "Retrieve the JSON Schema of the specified value descriptor"
 hide_title: true
 hide_table_of_contents: true
-api: eJzNVUtv1DAQ/ivRnEBy4xXccqLi0RbxWEFBSKs9uM7sxuDYxp50Kav8dzRO9lXaqhQO7CWr8bz8+Ztv1kBqmaCawXFKSMVbX6OFuQAfMCoy3p3VUMES6bOyHb7ApKMJ5ONH3WCrQEBQUbVIGDnLGpxqESo47qjx0fzMKUCAcVBBg6rGCALSEFytga4CuyeKxi2h78U2w5ejVz6uVKyxPppGT/6vs5z6RA9Kkj9j4PcO49U94xqVmvvHzQVETMG7hInPn0wm/KlHyBnHCmpcqM5SsfEEAdo7Qkfsq0KwRmfM5dfEAevfC/qLr6gZCDJk2fA6effO1wg9/8S1ih+QosFLLKjB4vKQBMXrj+/fFQMVShDQIjV+5EumBjVQgWyZVPIODiWMlxsCddEydEQhVVLW2PrSB3QRW09YGi9VMHIdUdm2lyDgUkWjLuyAWTYPqGWcoIJWJcLId5tzId1FQ1e5Eqc1NVSz+f5RbmrItnHYQac6ap6AgIX1q+yirUFHzyPW6Mgom43kv6H7lO8hOULmtpIcWpGB2ay9lUP+I+2dQ00yhwGzYBExNQ9PkLQPww1C9AuTH3nzjx9Y7Q/nc3555s6+8c9rsytz6r++eqa3cQufX2mk//uA7kNmV/FWObXEWJyen0+L4+kZXB+G88akwqQ8C7XXXYuOMmDFwsdsvSNbWRRTiyphkXAYp9lBjvmjLeu9Toesf5wLtD5iwf2X49wrneceW2UYMT56dhAHvQBrNLJUVDt1Ppm+KZ6WExDXxm21WpVL15U+LuUYlqRaBnv0tJyU6MqGWss5eVwHSPhgwqbgE7XK7ZX5E+k4wHk7cIQ/SAarjOMKudf1KCszyLIC4vblNBfQsOZXM1ivL1TCT9H2PZsHNWYRqE1i9aihWiibUMA3vNpJfm4aKgBW9VtcR5Xfuc53opTFRWy2zY31rl18q+bA03QTCkPVm9bj3d3+g0LjBj2oM3gda41h/+y3VcSwbPfDyctz6PtfXFfx2g==
+api: eJzNVE1vEzEQ/SvWnEBy11F72xNRQaWI0qhNuUQ5uN7ZrKnXNvZsQljtf0f2JiEpohJw4bSr+Xgz8zzzeiC5ilAuYBojErtxFRpYcnAegyTt7HUFJayQPkvT4VuMKmhPLtyrBlsJHLwMskXCkFB6sLJFKMcPB22hhK8dhi1wiGNK2QNtfQqKFLRdwTAsOQSM3tmIMfnPJ5P0qXbVtEswFdayM8T2kcBBOUtoKcVK741WuWPxJaaEfhiGgT8DuUMKGtfIqEH24f72ExsHYa7OpuhR6VpjxdZpXlYdBgYOLVLjdnTkyamBEkSbOBMvUBQxrPf8dMFACQ2Rj6UQFbaucB5twNYRFtoJ6bXoA0rTDgI4rGXQ8tGMvGTzyEzmAkpoZSQMMGQSI6ouaNrmSglWV1Aulseu3NSItg84vIeTHTXnwKE2bpNDlNFo6TJghZa0NNlI7gntQ55DpAyR24pibEX44MgpZ8SIf6actahI5DRIL10HjM3fA0Tl/DiBD67WJrW+/0svniBd0N/zMly6CvN+HBv/vHYKBf6fj573Xdva5VfSlN23Hu1d3i52I61cYWDv5/MZm86u4fl1zBsdmY75EiqnuhYtZcJY7UK2voBWMDYzKCOyiON9LU4wlq8OW+9UPN3617lA6wKy1H+xu22p8m1jK3ViLLnenOTBwMFohUkOyoP4TK9mH9lFMQH+7Nw2m02xsl3hwkrs0qKQK2/OLopJgbZoqDUJM53rSElyTJLJu0ittEdl/klLTog/XCDhNxLeSG1Tydx8v9OZBWSdAf57MV5yaFykFNv3jzLiQzDDkMyjBCdVqHRMclJBWUsTkcMTbn/qdW4USoAkGXvpyRLCoUFZYcggY85UKfR0lPWLBieUg2hevZvDMPwAFc1Ejw==
 sidebar_class_name: "get api-method"
 info_path: docs/rest-api/openremote-manager-http-api
 custom_edit_url: null
@@ -22,7 +22,7 @@ import Heading from "@theme/Heading";
 <Heading
   as={"h1"}
   className={"openapi__heading"}
-  children={"Retrieve the valueDescriptor JSON Schema."}
+  children={"Retrieve the JSON Schema of the specified value descriptor"}
 >
 </Heading>
 
@@ -36,7 +36,7 @@ import Heading from "@theme/Heading";
 
 
 
-Retrieve the valueDescriptor JSON Schema.
+Retrieve the JSON Schema of the specified value descriptor
 
 <Heading
   id={"request"}
@@ -47,7 +47,7 @@ Retrieve the valueDescriptor JSON Schema.
 </Heading>
 
 <ParamsDetails
-  parameters={[{"name":"Authorization","in":"header","schema":{"type":"string"}},{"name":"X-Forwarded-Proto","in":"header","schema":{"type":"string"}},{"name":"X-Forwarded-Host","in":"header","schema":{"type":"string"}},{"name":"name","in":"query","schema":{"type":"string"}},{"name":"hash","in":"query","schema":{"type":"string"}}]}
+  parameters={[{"name":"name","in":"query","schema":{"type":"string"}}]}
 >
 
 </ParamsDetails>
@@ -62,7 +62,7 @@ Retrieve the valueDescriptor JSON Schema.
 <StatusCodes
   id={undefined}
   label={undefined}
-  responses={{"200":{"description":"default response","content":{"application/json":{"schema":{"type":"object","title":"JsonNode"}}}}}}
+  responses={{"200":{"description":"default response","content":{"application/json":{}}}}}
 >
 
 </StatusCodes>

docs/rest-api/sidebar.ts

@@ -189,7 +189,7 @@ const sidebar: SidebarsConfig = {
         {
           type: "doc",
           id: "rest-api/get-value-descriptor-schema",
-          label: "Retrieve the valueDescriptor JSON Schema.",
+          label: "Retrieve the JSON Schema of the specified value descriptor",
           className: "api-method get",
         },
         {
@@ -1330,12 +1330,6 @@ const sidebar: SidebarsConfig = {
           label: "MetaItemDescriptorObject",
           className: "schema",
         },
-        {
-          type: "doc",
-          id: "rest-api/schemas/jsonnode",
-          label: "JsonNode",
-          className: "schema",
-        },
         {
           type: "doc",
           id: "rest-api/schemas/userassetlink",
@@ -1720,6 +1714,12 @@ const sidebar: SidebarsConfig = {
           label: "SentNotification",
           className: "schema",
         },
+        {
+          type: "doc",
+          id: "rest-api/schemas/jsonnode",
+          label: "JsonNode",
+          className: "schema",
+        },
         {
           type: "doc",
           id: "rest-api/schemas/notification",