[exports] Added API for initial delivery of feature

paths/exports_available.yaml

@@ -0,0 +1,52 @@
+get:
+  operationId: exportsAvailable
+  tags:
+    - Exports
+  summary: List available exports
+  responses:
+    '200':
+      description: |-
+        Lists all available HIS export snapshots.
+        A HIS export snapshot contains parts of medical dossier info for a subset of all patients in a GP practice. Exactly which filters are applied,
+        which data is provided, and how it is formatted is arranged between Zorg op Orde and a party using the ZOO API.
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              exportSources:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    agb:
+                      $ref: ../schemas/agb.yaml
+                    name:
+                      type: string
+                      description: Name of the GP practice
+                    available:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          filename:
+                            type: string
+                            description: |-
+                              This filename can be used in the `/agb/filename` endpoint to fetch this data.
+                          timestamp:
+                            type: string
+                            format: date-time
+                            description: |-
+                              The export contains data sourced from an EPD system at this time; it will not
+                              contain any medical dossier data later than this timestamp.
+                        required:
+                          - filename
+                          - timestamp
+                  required:
+                    - agb
+                    - name
+                    - available
+    '401':
+      $ref: '../zoo-api.yaml/#/components/responses/NoAuth'
+    '403':
+      $ref: '../zoo-api.yaml/#/components/responses/NoAccess'

paths/exports_{agb}_{filename}.yaml

@@ -0,0 +1,26 @@
+get:
+  operationId: exportsDownload
+  tags:
+    - Exports
+  summary: Download an available export
+  parameters:
+    - name: agb
+      in: path
+      description: The AGB code of the practice for the export file you want to download.
+      required: true
+      schema:
+        $ref: ../schemas/agb.yaml
+    - name: filename
+      in: path
+      required: true
+      description: The name of the file as provided by the `/exports/available` endpoint.
+      schema:
+        type: string
+  responses:
+    '200':
+      description: |-
+        Fetches the requested HIS export as ZIP file.
+    '401':
+      $ref: '../zoo-api.yaml/#/components/responses/NoAuth'
+    '403':
+      $ref: '../zoo-api.yaml/#/components/responses/NoAccess'

zoo-api.yaml

@@ -20,8 +20,7 @@ security:
 tags:
   - name: Patient
     description: |-
-      API for retrieving medical dossier data and concerns based on looking up a
+      API for retrieving medical dossier data and concerns based on looking up a specific patient.
-      specific patient.
   - name: Population statistics
     description: |-
       Statistics of a patient population.
@@ -42,6 +41,9 @@ tags:
 
       As well as a 'config' view where they see _all_ care programs that could possibly be relevant for that customer, where the customer can preview the report (essentially, run the report as normal), favourite something they don't get by default, or unfavourite something they get by default.
   - name: Customer management
+  - name: Exports
+    description: |-
+      List and download exported parts of HIS dossiers.
 paths:
   /patient/dossier:
     $ref: 'paths/patient_dossier.yaml'
@@ -89,6 +91,10 @@ paths:
     $ref: 'paths/customer_careprogram_periodEnd.yaml'
   /customer/basic:
     $ref: 'paths/customer_basic.yaml'
+  /exports/available:
+    $ref: 'paths/exports_available.yaml'
+  /exports/{agb}/{filename}:
+    $ref: 'paths/exports_{agb}_{filename}.yaml'
 components:
   parameters:
     Authorization: