[api] Added dossier to frequent user patients API.

paths/population_frequentUser_patients.yaml

@@ -47,13 +47,13 @@ get:
           $ref: ../schemas/pat-patId.yaml
     - name: pii
       in: query
-      description: "Allow patient personal identifying information in the response. Defaults to false if omitted."
+      description: "Allow personal identifying information in the response. Defaults to false if omitted. If false, only category, doctor, patid, patUnid and feats are in the response. In other words: they are always in the response, but can be extended with other pii properties, see non-required properties below."
       example: true
       schema:
         type: boolean
     - name: limit
       in: query
-      description: "Some integer between 1 and 50. Limits the output to the top 1 to 50 of the frequent users (patients). Defaults to 20 if omitted or not in the specified range."
+      description: "Limits the output to the top 1 to 50 of the frequent users (patients). Defaults to 20 if omitted or not in the specified range."
       schema:
         type: integer
         minimum: 1
@@ -67,22 +67,35 @@ get:
             type: array
             items: 
               type: object
+              required:
+                - category
+                - doctor
+                - patid
+                - patUnid
+                - feats
               properties:
-                patId:
+                bsn:
-                  type: string
+                  $ref: '../schemas/PatIdentity.yaml#/bsn'
-                  example: 1349
+                name:
-                lastName:
+                  $ref: '../schemas/PatIdentity.yaml#/name'
-                  type: string
-                  example: van Loon - van de Ven
-                  description: Omitted if parameter pii is omitted or false.
                 gender:
-                  type: string
+                  $ref: '../schemas/PatIdentity.yaml#/gender'
-                  example: V
+                dob:
-                  description: Omitted if parameter pii is omitted or false.
+                  $ref: '../schemas/PatIdentity.yaml#/dob'
-                birthdate:
+                category:
-                  type: string
+                  $ref: '../schemas/PatIdentity.yaml#/category'
-                  example: 1929-08-21
+                doctor:
-                  description: Omitted if parameter pii is omitted or false.
+                  $ref: '../schemas/PatIdentity.yaml#/doctor'
+                address:
+                  $ref: '../schemas/PatIdentity.yaml#/address'
+                contact:
+                  $ref: '../schemas/PatIdentity.yaml#/contact'
+                insurance:
+                  $ref: '../schemas/PatIdentity.yaml#/insurance'
+                patid:
+                  $ref: '../schemas/PatIdentity.yaml#/patid'
+                patUnid:
+                  $ref: '../schemas/PatIdentity.yaml#/patUnid'
                 feats:
                   type: object
                   properties: