[lint] Fixing warnings and errors.

paths/patient_contactList.yaml

@@ -7,7 +7,7 @@ get:
   parameters: 
     - name: patUnids
       in: query
-      mandatory: true
+      required: true
       description: |-
         A comma separated list of patUnid values, as provided by other API endpoints.
         For each patUnid the contact details are in the response. If sending lots of patUnids, we suggest you call this API in a POST (which is also allowed, though the semantic intent of this method is GET: It only queries and makes no changes) to avoid HTTP limits on query length.
@@ -18,9 +18,27 @@ get:
         example: "1234,5678"
     - name: fields
       in: query
-      mandatory: true
+      required: true
+      schema:
+        type: array
+        items:
+          type: string
+          enum:
+            - bsn
+            - patPubId
+            - patUnid
+            - gender
+            - displayName
+            - fullName
+            - addressLine
+            - postcode
+            - city
+            - tel
+            - email
+            - dob
+      explode: false
       description: |-
-        Comma separated list of data fields that shold be returned in the response. Available options are:
+        Comma separated list of data fields that should be returned in the response. Available options are:
         bsn         - adds CSV column/JSON key 'bsn'.
         patPubId    - adds CSV column/JSON key 'patPubId'.
         patUnid     - adds CSV column/JSON key 'patUnid'.

zoo-api.yaml

@@ -42,7 +42,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
     description: |-
+      Update and query properties of ZOO customers (such as who is the contact person and which care programs they participate in).
   - name: EPD exports
+    description: |-
       List and download exported parts of EPD (General Practioner Information Systems) dossiers.
 paths:
   /patient/dossier:
@@ -238,7 +240,6 @@ components:
       description: Indicated practice is known but has not authorized ZOO to share this information with signer.
   securitySchemes:
     BearerAuth:
-      in: header
       type: http
       scheme: bearer
       bearerFormat: JWT