Sketch route for retrieving original file

modules/restapi/src/main/resources/docspell-openapi.yml

@@ -1172,7 +1172,8 @@ paths:
       tags: [ Attachment ]
       summary: Get an attachment file.
       description: |
-        Get the binary file belonging to the attachment with the given id.
+        Get information about the binary file belonging to the
+        attachment with the given id.
       security:
         - authTokenHeader: []
       parameters:
@@ -1198,7 +1199,60 @@ paths:
       tags: [ Attachment ]
       summary: Get an attachment file.
       description: |
-        Get the binary file belonging to the attachment with the given id.
+        Get the binary file belonging to the attachment with the given
+        id.
+      security:
+        - authTokenHeader: []
+      parameters:
+        - $ref: "#/components/parameters/id"
+      responses:
+        200:
+          description: Ok
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
+  /sec/attachment/{id}/original:
+    head:
+      tags: [ Attachment ]
+      summary: Get an attachment file.
+      description: |
+        Get information about the original binary file of the
+        attachment with the given id.
+
+        If the attachment is a converted PDF file, this route gets the
+        original file as it was uploaded.
+      security:
+        - authTokenHeader: []
+      parameters:
+        - $ref: "#/components/parameters/id"
+      responses:
+        200:
+          description: Ok
+          headers:
+            Content-Type:
+              schema:
+                type: string
+            Content-Length:
+              schema:
+                type: integer
+                format: int64
+            ETag:
+              schema:
+                type: string
+            Content-Disposition:
+              schema:
+                type: string
+    get:
+      tags: [ Attachment ]
+      summary: Get an attachment file.
+      description: |
+        Get the original binary file of the attachment with the given
+        id.
+
+        If the attachment is a converted PDF file, this route gets the
+        original file as it was uploaded.
       security:
         - authTokenHeader: []
       parameters: