Json API v2 initial documentation

docs/3.1/_toc.yml

@@ -125,9 +125,15 @@ subtrees:
           entries:
           - file: json-api/index
             title: "HTTP JSON API Service"
+          - file: json-api/openapi
+            title: "HTTP JSON API Openapi specification"
+          - file: json-api/asyncapi
+            title: "HTTP JSON API Asyncapi specification"
           - file: json-api/lf-value-specification
+            title: "Legacy HTTP JSON API Service (V1)"
+          - file: json-api/v1/index
             title: "Daml-LF JSON Encoding"
-          - file: json-api/search-query-language
+          - file: json-api/v1/search-query-language
             title: "Query Language"
           - file: app-dev/bindings-ts/index
             title: "Use JavaScript Client Libraries with Daml"

docs/3.1/bin/build

@@ -2,6 +2,7 @@
 # Copyright (c) 2022 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 
+set -x
 set -eou pipefail
 
 DIR="$( cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
@@ -98,3 +99,4 @@ rm -r $BUILD_DIR/sphinx-target/html/.buildinfo $BUILD_DIR/sphinx-target/html/.do
 )
 
 tar cfz $TARGET_DIR/html-$prefix.tar.gz -C $BUILD_DIR/sphinx-target html
+echo "finished"

docs/3.1/docs/json-api/asyncapi.rst

@@ -0,0 +1,16 @@
+
+JSON API V2 Asyncapi definition
+###############################
+
+This section contains a copy of the asyncapi/openapi specification.
+
+If you start Canton with the HTTP API enabled, this specification is available under http://<host>:<port>/docs/asyncapi
+
+The sources below can be copied to `Editor swagger IO <https://editor-next.swagger.io>`_ . The editor displays a preview of the specification and generates example inputs and outputs.
+
+The specification covers streaming (websockets) endpoints - for regular endpoints (HTTP) please see :doc:`openapi`
+
+Properties of type: `{}` (any JSON) are DAML types as defined in the Daml template and formatted according to :doc:`lf-value-specification`.
+
+.. literalinclude:: openapi/asyncapi.yaml
+  :language: yaml