rewrote specs

spec.yaml

@@ -257,13 +257,15 @@ definitions:
         example: John Doe
       shareType:
         type: string
+        enum: ["user", "group"]
         description: |
-          Recipient share type (user or group)
+          Recipient share type
         example: user
       resourceType:
         type: string
+        enum: ["file", "folder"]
         description: |
-          Resource type (file, calendar, contact, ...)
+          Resource type
         example: file
       protocols:
         type: object
@@ -281,18 +283,40 @@ definitions:
           `webapp`, to access remote web applications
           `datatx`, to transfer the data to the remote endpoint
           Other custom protocols might be added in the future.
-        example:
-          webdav:
-            sharedSecret: "secret"
-            permissions: ["read", "write", "share"]
-            uri: "https://open-cloud-mesh.org/remote.php/webdav/path/to/resource"
-          webapp:
-            sharedSecret: "secret"
-            uriTemplate: "https://open-cloud-mesh.org/s/{share-id}/{relative-path-to-shared-resource}"
-          datatx:
-            sharedSecret: "secret"
-            srcUri: "https://open-cloud-mesh.org/remote.php/webdav/path/to/resource"
-            size: 1000000000000
+        anyOf:
+          properties:
+            webdav:
+              type: object
+              allOf:
+                properties:
+                  sharedSecret:
+                    type: string
+                  permissions:
+                    type: array
+                    items:
+                      type: string
+                      enum: ["read", "write", "share"]
+                  uri:
+                    type: string
+                    example: "https://open-cloud-mesh.org/remote.php/webdav/path/to/resource"
+            webapp:
+              type: object
+              allOf:
+                properties:
+                  uriTemplate: string
+                  example: "https://open-cloud-mesh.org/s/share-hash/{relative-path-to-shared-resource}"
+            datatx:
+              type: object
+              allOf:
+                properties:
+                  sharedSecret:
+                    type: string
+                  srcUri:
+                    type: string
+                    example: "https://open-cloud-mesh.org/remote.php/webdav/path/to/resource"
+                  size:
+                    type: integer
+                    example: 1000000000000
   NewNotification:
     type: object
     required: