chore(qes): add documents endpoint (#99)

openapi.yaml

@@ -102,6 +102,9 @@ paths:
     $ref: paths/id_photos.yaml#/id_photo
   /id_photos/{id_photo_id}/download:
     $ref: paths/id_photos.yaml#/download
+  # Qualified Electronic Signature
+  /qualified_electronic_signature/documents:
+    $ref: paths/qualified_electronic_signature.yaml#/documents
   # Timeline Files
   /workflow_runs/{workflow_run_id}/timeline_file:
     $ref: paths/timeline_files.yaml#/timeline_files

paths/qualified_electronic_signature.yaml

@@ -0,0 +1,40 @@
+documents:
+  post:
+    summary: Retrieves the signed document or application form
+    operationId: download_qes_document
+    description: >
+      Retrieves the signed document or application form depending on the file_id provided.
+    parameters:
+      - name: workflow_run_id
+        in: query
+        required: true
+        description: The unique identifier of the Workflow Run for which you want to retrieve the signed document.
+        schema:
+          type: string
+          format: uuid
+      - name: file_id
+        in: query
+        required: true
+        description: The unique identifier of the file which you want to retrieve.
+        schema:
+          type: string
+          format: uuid
+
+    responses:
+      "302":
+        description: Found
+        headers:
+          Location:
+            description: Pre-signed URL to download the file.
+            schema:
+              type: string
+              format: uri
+      "200":
+        description: The signed document PDF binary data.
+        content:
+          application/pdf:
+            schema:
+              type: string
+              format: binary
+      default:
+        $ref: ../responses/default_error.yaml

shell/patch-openapi-definition.py

@@ -29,6 +29,7 @@ class Section:
              'motion_captures': 'Motion captures',
              'watchlist_monitors': 'Monitors',
              'id_photos': 'ID Photos',
+             'qualified_electronic_signature': 'Qualified Electronic Signature',
              'timeline_file': 'Timeline Files'
              }),
     Section('Other Endpoints',