feat: return all exceptions in JSON

.gitignore

@@ -9,4 +9,7 @@ __pycache__
 .env
 
 # Instance
-instance
+instance
+
+# IDE
+.vscode

src/api/shared/handle_http_exception.py

@@ -0,0 +1,23 @@
+"""
+This module handlers all exceptions regarding HTTP error codes
+"""
+
+from flask import json, Blueprint
+from werkzeug.exceptions import HTTPException
+
+errors_bp = Blueprint('errors', __name__)
+
+
+@errors_bp.app_errorhandler(HTTPException)
+def handle_exception(e):
+    """Return JSON instead of HTML for HTTP errors."""
+    # start with the correct headers and status code from the error
+    response = e.get_response()
+    # replace the body with JSON
+    response.data = json.dumps({
+        "code": e.code,
+        "name": e.name,
+        "description": e.description,
+    })
+    response.content_type = "application/json"
+    return response

src/app.py

@@ -28,6 +28,9 @@ def create_app():
     from .api.health.health_controller import health_bp
     app.register_blueprint(health_bp)
 
+    from .api.shared.handle_http_exception import errors_bp
+    app.register_blueprint(errors_bp)
+
     # ensure the instance folder exists
     try:
         os.makedirs(app.instance_path)