Merge remote-tracking branch 'origin/discounts-rest' into discounts-rest

Author: adriendupuis

docs/api/rest_api/rest_api_reference/input/examples/discount_codes/apply/POST/DiscountCodeResponse.json.example

@@ -2,7 +2,7 @@
     "DiscountCode": {
         "_media-type": "application\/vnd.ibexa.api.DiscountCode+json",
         "id": 1,
-        "code": "my_secret_code",
+        "code": "summer10",
         "created_at": {
             "date": "2025-06-10 14:14:06.000000",
             "timezone_type": 3,

docs/api/rest_api/rest_api_reference/input/ibexa-discounts-codes.raml

@@ -15,14 +15,14 @@ displayName: Discount Codes
                         application/vnd.ibexa.api.DiscountCode+json
             body:
                 application/vnd.ibexa.api.DiscountCode+json:
-                    type: DiscountCode
+                    type: DiscountCodeWrapper
                     example: !include examples/discount_codes/apply/POST/DiscountCode.json.example
             responses:
                 200:
                     description: Discount applied successfully
                     body:
                         application/vnd.ibexa.api.DiscountCode+json:
-                            type: DiscountCode
+                            type: DiscountCodeWrapper
                             example: !include examples/discount_codes/apply/POST/DiscountCodeResponse.json.example
                 400:
                     description: Error - the request is invalid.
@@ -46,7 +46,7 @@ displayName: Discount Codes
                         application/vnd.ibexa.api.DiscountCode+json
             body:
                 application/vnd.ibexa.api.DiscountCode+json:
-                    type: DiscountCode
+                    type: DiscountCodeWrapper
                     example: !include examples/discount_codes/apply/POST/DiscountCode.json.example
             responses:
                 204:

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

@@ -39,10 +39,14 @@ post:
                 application/vnd.ibexa.api.Discount+json:
                     type: DiscountWrapper
                     example: !include examples/discounts/POST/DiscountCreateResponse.json.example
+        400:
+            description: Error - the request is invalid.
+        401:
+            description: Error - the user is not authorized to execute an AI action.
 
 /{id}:
     get:
-        displayName: Get discount
+        displayName: Get discount by ID
         description: Returns a discount with the specified numerical ID
         headers:
             Accept:
@@ -55,10 +59,12 @@ post:
                     application/vnd.ibexa.api.Discount+json:
                         type: DiscountWrapper
                         example: !include examples/discounts/Discount.json.example
+        401:
+            description: Error - the user is not authorized to create a discount
 
 /{identifier}:
     get:
-        displayName: Get discount
+        displayName: Get discount by identifier
         description: Returns a discount with the specified identifier
         headers:
             Accept:
@@ -94,13 +100,25 @@ post:
                     application/vnd.ibexa.api.Discount+json:
                         type: DiscountWrapper
                         example: !include examples/discounts/identifier/PATCH/DiscountUpdateResponse.json.example
+            400:
+                description: Error - the request is invalid.
+            401:
+                description: Error - the user is not authorized to update the discount.
+            404:
+                description: Error - the specified discount was not found.
 
     delete:
         displayName: Delete discount
         description: Deletes a discount
         responses:
             204:
                 description: Discount deleted successfully.
+            400:
+                description: Error - the request is invalid.
+            401:
+                description: Error - the user is not authorized to update the discount.
+            404:
+                description: Error - the specified discount was not found.
 
     /enable:
         post:
@@ -109,6 +127,12 @@ post:
             responses:
                 204:
                     description: Discount enabled successfully.
+            400:
+                description: Error - the request is invalid.
+            401:
+                description: Error - the user is not authorized to update the discount.
+            404:
+                description: Error - the specified discount was not found.
 
     /disable:
         post:
@@ -117,3 +141,9 @@ post:
             responses:
                 204:
                     description: Discount disabled successfully.
+            400:
+                description: Error - the request is invalid.
+            401:
+                description: Error - the user is not authorized to update the discount.
+            404:
+                description: Error - the specified discount was not found.