Continue /cart/authorize route doc

Author: adriendupuis

docs/api/rest_api/rest_api_reference/input/examples/cart/authorize/Token.json.example

@@ -0,0 +1,6 @@
+{
+    "Token": {
+        "_media-type": "application\/vnd.ibexa.api.Token+json",
+        "value": "DLDDLD.LLLLLDLLLLDLLLLLDLLLLLLLDLLDLLLD_D_LLDDLLLL._LLLDLL-LLLLLLLLLLDLLDLLLLLLLDLLLLLLLLL-LLLLLLLLLLLLLLLDLL"
+    }
+}

docs/api/rest_api/rest_api_reference/input/examples/cart/view/CartView.json.example

@@ -0,0 +1,38 @@
+{
+    "CartView": {
+        "_media-type": "application\/vnd.ibexa.api.CartView+json",
+        "identifier": "loadUserCarts",
+        "Result": {
+            "_media-type": "application\/vnd.ibexa.api.ViewResult+json",
+            "count": 1,
+            "CartList": {
+                "_media-type": "application\/vnd.ibexa.api.CartList+json",
+                "Cart": [
+                    {
+                        "_media-type": "application\/vnd.ibexa.api.Cart+json",
+                        "id": 1,
+                        "identifier": "289ab191-c6ea-45af-9adb-a5060d997361",
+                        "name": "Default",
+                        "createdAt": "2024-09-25T14:44:07+00:00",
+                        "updatedAt": "2024-09-25T14:44:07+00:00",
+                        "owner": {
+                            "_media-type": "application\/vnd.ibexa.api.User+json",
+                            "_href": "\/api\/ibexa\/v2\/user\/users\/10"
+                        },
+                        "Currency": {
+                            "_media-type": "application\/vnd.ibexa.api.Currency+json",
+                            "id": 2,
+                            "code": "EUR",
+                            "subunits": 2,
+                            "enabled": true
+                        },
+                        "entries": [],
+                        "context": {
+                            "foo": "bar"
+                        }
+                    }
+                ]
+            }
+        }
+    }
+}

docs/api/rest_api/rest_api_reference/input/ibexa-cart.raml

@@ -58,6 +58,7 @@ post:
                         type: CartView
                     application/vnd.ibexa.api.CartView+json:
                         type: CartViewWrapper
+                        example: !include examples/cart/view/CartView.json.example
 /{identifier}:
     get:
         displayName: Get Cart
@@ -185,4 +186,17 @@ post:
 /authorize:
     post:
         displayName: Cart Authorization
-        description: Return the CSRF token needed by anonymous users to manipulate their Cart
+        description: Returns the CSRF token required by anonymous user to interact with own cart.
+        headers:
+            Accept:
+                example: |
+                    application/vnd.ibexa.api.Token+xml
+                    application/vnd.ibexa.api.Token+json
+        responses:
+            200:
+                body:
+                    application/vnd.ibexa.api.Token+xml:
+                        type: Token
+                    application/vnd.ibexa.api.CartConstraintViolationList+json:
+                        type: Token
+                        example: !include examples/cart/authorize/Token.json.example

docs/api/rest_api/rest_api_reference/input/ibexa-types.raml

@@ -3593,7 +3593,7 @@ CartListViewResult:
     type: object
     properties:
         count: integer
-        Result: CartList
+        CartList: CartList
 
 CartList:
     description: 'This class represents a cart list.'
@@ -3637,6 +3637,12 @@ CartConstraintViolation:
         propertyPath: string
         message: string
 
+Token:
+    description: 'This class represents a CSRF token'
+    type: object
+    properties:
+        value: string
+
 CatalogWrapper:
     description: 'JSON object with only a Catalog property.'
     type: object