From 5b9a836c656b93b92e691ac732a0cf095653af3c Mon Sep 17 00:00:00 2001
From: Nico Kroll <kroll@prm-ag.de>
Date: Wed, 20 Aug 2025 10:33:58 +0200
Subject: [PATCH] V10 - rework of Blob-Handling

---
 src/v2/shop.yaml | 57 +++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 51 insertions(+), 6 deletions(-)

diff --git a/src/v2/shop.yaml b/src/v2/shop.yaml
index 28e4c21..87503d8 100644
--- a/src/v2/shop.yaml
+++ b/src/v2/shop.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
     title: "TyrePro-API, Shop"
-    version: "Version 9"
+    version: "Version 10"
 servers:
     - url: "https://musterreifen.com/api/shop"
       description: "Development server, customers domain"
@@ -105,6 +105,7 @@ paths:
       - "Settings"
       parameters:
       - $ref: "#/components/parameters/GuidOnlineService"
+      - $ref: "#/components/parameters/BinaryObjectContentType"
       responses:
         200:
           description: "successful operation"
@@ -125,6 +126,7 @@ paths:
       parameters:
       - $ref: "#/components/parameters/GuidPath"
       - $ref: "#/components/parameters/_HashValue"
+      - $ref: "#/components/parameters/BinaryObjectContentType"
       requestBody:
         required: true
         content:
@@ -319,6 +321,7 @@ paths:
       tags:
       - "Menu"
       parameters:
+      - $ref: "#/components/parameters/BinaryObjectContentType"
       - name: "GuidModule"
         in: "query"
         required: true
@@ -1098,6 +1101,35 @@ components:
           example: 
             Message: "Ihr Anwender wurde nicht gefunden."
             Details: "Progress.Lang.AppError\n  Ihr Anwender wurde nicht gefunden.\nat sourcecode.line 123"
+        DbBlob:
+          type: "object"
+          required: 
+            - "Designation"
+            - "MimeType"
+            - "CharacterSet"
+            - "LastFileModificationMoment"
+            - "Content"
+            - "ContentHashValue"
+            - "SizeInBytes"
+          properties:
+            Designation:
+              type: "string"
+            MimeType:
+              type: "string"
+              readOnly: true
+            CharacterSet:
+              type: "string"
+            LastFileModificationMoment:
+              type: "string"
+              format: "date-time"
+            Content:
+              type: "string"
+            ContentHashValue:
+              type: "string"
+              readOnly: true
+            SizeInBytes:
+              type: "integer"
+              readOnly: true
         AddressState:
           type: "object"
           required: 
@@ -1559,8 +1591,8 @@ components:
             OfferLayout:
               type: "object"
               properties:
-                GuidDbBlobBackground:
-                  type: "string"
+                BackgroundImage:
+                  $ref: "#/components/schemas/DbBlob"
                 TopOffsetInPixel:
                   type: "integer"
                 BottomOffsetInPixel:
@@ -1747,13 +1779,13 @@ components:
           type: "object"
           required:
             - "Guid"
-            - "GuidDbBlob"
+            - "File"
             - "Type"
           properties:
             Guid:
               type: "string"
-            GuidDbBlob:
-              type: "string"
+            File:
+              $ref: "#/components/schemas/DbBlob"
             Type:
               type: "string"
               enum:
@@ -1927,6 +1959,19 @@ components:
           type: "string"
           default: null
           example: "2055516"
+      BinaryObjectContentType:
+        name: "BinaryObjectContentType"
+        in: "query"
+        description: "Determines what you will find in the field content."
+        required: false
+        schema:
+          type: "string"
+          enum:
+            - "Base64"
+            - "UrlWithInlineContentDisposition"
+            - "UrlWithAttachmentContentDisposition"
+          default: "UrlWithInlineContentDisposition"
+          example: "UrlWithInlineContentDisposition"
     responses:
       GenericError:
         description: "Unexpected error like 4XX or 5XX http errors."