generalize response status 400 description (#99 SPECITS-70)

specifications/operations/composition_create.yaml

@@ -19,7 +19,7 @@ responses:
   '201':
     $ref: ../responses/201_COMPOSITION.yaml
   '400':
-    $ref: ../responses/400_COMPOSITION.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id.yaml
   '422':

specifications/operations/composition_update.yaml

@@ -27,7 +27,7 @@ responses:
   '200':
     $ref: ../responses/200_COMPOSITION_updated.yaml
   '400':
-    $ref: ../responses/400_COMPOSITION.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id_or_uid_based_id.yaml
   '412':

specifications/operations/definition_query_store.yaml

@@ -25,4 +25,4 @@ responses:
   '200':
     $ref: ../responses/200_StoredQuery_stored.yaml
   '400':
-    $ref: ../responses/400_StoredQuery.yaml
+    $ref: ../responses/400.yaml

specifications/operations/definition_query_version_store.yaml

@@ -26,6 +26,6 @@ responses:
   '200':
     $ref: ../responses/200_StoredQuery_stored.yaml
   '400':
-    $ref: ../responses/400_StoredQuery.yaml
+    $ref: ../responses/400.yaml
   '409':
     $ref: ../responses/409_StoredQuery_version.yaml

specifications/operations/definition_template_adl1.4_get.yaml

@@ -13,7 +13,7 @@ responses:
   '200':
     $ref: ../responses/200_Template_adl1_4_retrieved.yaml
   '400':
-    $ref: ../responses/400_invalid_template_id.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_template_id.yaml
   '406':

specifications/operations/definition_template_adl1.4_upload.yaml

@@ -72,6 +72,6 @@ responses:
   '201':
     $ref: ../responses/201_Template_adl1_4_upload.yaml
   '400':
-    $ref: ../responses/400_invalid_template_content.yaml
+    $ref: ../responses/400.yaml
   '409':
     $ref: ../responses/409_template_already_exists.yaml

specifications/operations/definition_template_adl2_get.yaml

@@ -10,6 +10,6 @@ responses:
   '200':
     $ref: ../responses/200_Template_adl2_retrieved.yaml
   '400':
-    $ref: ../responses/400_invalid_template_id.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_template_id.yaml

specifications/operations/definition_template_adl2_upload.yaml

@@ -37,6 +37,6 @@ responses:
   '201':
     $ref: ../responses/201_Template_adl2_upload.yaml
   '400':
-    $ref: ../responses/400_invalid_template_content.yaml
+    $ref: ../responses/400.yaml
   '409':
     $ref: ../responses/409_template_already_exists.yaml

specifications/operations/definition_template_adl2_version_get.yaml

@@ -12,6 +12,6 @@ responses:
   '200':
     $ref: ../responses/200_Template_adl2_retrieved.yaml
   '400':
-    $ref: ../responses/400_invalid_template_id.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_template_id_or_version.yaml

specifications/operations/directory_create.yaml

@@ -19,6 +19,6 @@ responses:
   '201':
     $ref: ../responses/201_directory.yaml
   '400':
-    $ref: ../responses/400_FOLDER.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id.yaml

specifications/operations/directory_delete.yaml

@@ -13,7 +13,7 @@ responses:
   '204':
     $ref: ../responses/204_because_deleted.yaml
   '400':
-    $ref: ../responses/400_invalid_ehr_id.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id.yaml
   '412':

specifications/operations/directory_update.yaml

@@ -24,7 +24,7 @@ responses:
   '204':
     $ref: ../responses/204_directory_updated.yaml
   '400':
-    $ref: ../responses/400_FOLDER.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id.yaml
   '412':

specifications/operations/ehr_status_get_at_time.yaml

@@ -13,6 +13,6 @@ responses:
   '200':
     $ref: ../responses/200_EHR_STATUS_retrieved.yaml
   '400':
-    $ref: ../responses/400_invalid_version_at_time.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id_or_no_version_at_time.yaml

specifications/operations/versioned_ehr_status_version_get_at_time.yaml

@@ -13,6 +13,6 @@ responses:
   '200':
     $ref: ../responses/200_VERSION_of_EHR_STATUS_at_time.yaml
   '400':
-    $ref: ../responses/400_invalid_version_at_time.yaml
+    $ref: ../responses/400.yaml
   '404':
     $ref: ../responses/404_unknown_ehr_id_or_no_version_at_time.yaml

specifications/responses/400.yaml

@@ -1,2 +1,7 @@
 description: |
-  `400 Bad Request` is returned when the request URL or body (if provided) could not be parsed or has invalid content.
+  `400 Bad Request` is returned when the request could not be parsed or is invalid (e.g. malformed request URL syntax, missing required header or parameter, or syntactically invalid header, parameter or content). 
+  The response body MAY contain error details.
+content:
+  application/json:
+    schema:
+      $ref: ../schemas/others/Error.yaml

specifications/responses/400_CONTRIBUTION.yaml

@@ -1,5 +1,6 @@
 description: |
-  `400 Bad Request` is returned when the request URL or body could not be parsed or has invalid content (e.g. invalid `ehr_id`, or either the body of the request not be converted to a valid CONTRIBUTION object, or the modification type doesn’t match the operation - i.e. first version of a composition with MODIFICATION).
+  `400 Bad Request` is returned when the request could not be parsed or is invalid (e.g. malformed request URL syntax, missing required header or parameter, or syntactically invalid header, parameter or content, or the modification type does not match the operation - i.e. first version of a MODIFICATION).
+  The response body MAY contain error details.
 content:
   application/json:
     schema:

specifications/responses/400_already_deleted.yaml

@@ -1,2 +1,2 @@
 description: |
-  `400 Bad Request` is returned when the request URL could not be parsed (i.e. invalid format of request parameters) or when the resource identified by the request parameters is already deleted.
+  `400 Bad Request` is returned when the request could not be parsed or is invalid (e.g. malformed request URL syntax, missing required header or parameter, or syntactically invalid header, parameter or content) or when the resource identified by the request parameters is already deleted.