[bugfix] Updated 400 response specification with ref and fixed incorrect definition.

paths/population_frequentUser_count.yaml

@@ -61,6 +61,8 @@ get:
                     - {visits: 1, frequency: 355} 
                     - {visits: 2, frequency: 240}
                     - {visits: 4, frequency: 25}
+    400:
+      $ref: '../zoo-api.yaml#/components/responses/ReqFailure'
     401:
       $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
     403:

paths/population_frequentUser_patient.yaml

@@ -79,6 +79,8 @@ get:
                         - S74.02
                         - Y07.00
                         - K87.00
+    400:
+      $ref: '../zoo-api.yaml#/components/responses/ReqFailure'
     401:
       $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
     403:

paths/population_frequentUser_patients.yaml

@@ -98,6 +98,8 @@ get:
                         n:
                           type: number
                           example: 54
+    400:
+      $ref: '../zoo-api.yaml#/components/responses/ReqFailure'
     401:
       $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
     403:

paths/population_statistics.yaml

@@ -86,7 +86,7 @@ get:
                       description: "The number of unique patients in the group."
                       example: 7
     400:
-      description: "Common HTTP semantics, see the response body."
+      $ref: '../zoo-api.yaml#/components/responses/ReqFailure'
     401:
       $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
     403:

paths/population_statistics_deprived.yaml

@@ -46,7 +46,7 @@ get:
                   minimum: 0
                   example: 0
     400:
-      description: "Common HTTP semantics, see the response body."
+      $ref: '../zoo-api.yaml#/components/responses/ReqFailure'
     401:
       $ref: '../zoo-api.yaml#/components/responses/JwtFailure'
     403:

zoo-api.yaml

@@ -148,16 +148,16 @@ components:
         type: string
   responses:
     ReqFailure:
-      description: |-
-        The request isn't valid; for example, it is missing a required parameter.
+      description: The request isn't valid; for example, it is missing a required parameter.
       content:
         application/json:
+          schema:
             type: object
             properties:
               err:
                 description: A plain text explanation of what's wrong with the request
                 type: string
-                example: Either pu or bsn query parameter needs to be present and not blank.
+                example: Either x or y query parameter needs to be present and not blank.
     JwtFailure:
       description: |-
         The JWT token isn't valid or wasn't provided.