refactor: Add example to ScriptNotFoundError, ScriptParsingFailureError

Author: caoccao

ext/hivemq-edge-openapi-2025.9.yaml

@@ -5780,21 +5780,25 @@ components:
             id:
               type: string
               description: The script ID.
-            message:
-              type: string
-              description: The error message.
+              example: abc
           required:
             - id
+      example:
+        general:
+          status: 404
+          title: Script Not Found
+          detail: Script with ID 'abc' is not found.
+          id: abc
+          type: https://hivemq.com/edge/api/model/ScriptNotFoundError
     ScriptParsingFailureError:
       allOf:
         - $ref: '#/components/schemas/ApiError'
-        - type: object
-          properties:
-            reason:
-              type: string
-              description: The actual reason.
-          required:
-            - reason
+      example:
+        general:
+          status: 400
+          title: Script Parsing Failure
+          detail: The given script 'abc' could not be parsed.
+          type: https://hivemq.com/edge/api/model/ScriptParsingFailureError
     ScriptReferencedError:
       allOf:
         - $ref: '#/components/schemas/ApiError'

ext/openAPI/components/schemas/errors/datahub/ScriptNotFoundError.yaml

@@ -5,8 +5,13 @@ allOf:
       id:
         type: string
         description: The script ID.
-      message:
-        type: string
-        description: The error message.
+        example: "abc"
     required:
       - id
+example:
+  general:
+    status: 404
+    title: "Script Not Found"
+    detail: "Script with ID 'abc' is not found."
+    id: "abc"
+    type: "https://hivemq.com/edge/api/model/ScriptNotFoundError"

ext/openAPI/components/schemas/errors/datahub/ScriptParsingFailureError.yaml

@@ -1,9 +1,8 @@
 allOf:
   - $ref: "../ApiError.yaml"
-  - type: object
-    properties:
-      reason:
-        type: string
-        description: The actual reason.
-    required:
-      - reason
+example:
+  general:
+    status: 400
+    title: "Script Parsing Failure"
+    detail: "The given script 'abc' could not be parsed."
+    type: "https://hivemq.com/edge/api/model/ScriptParsingFailureError"