🐛 [REST API] Respond with 403 when max allowed limit for entities is exceeded

[MDeLuise]

Overview

This pull request fixes an issue where exceeding the maximum allowed limit for entities resulted in the server returning an incorrect HTTP 500 (Internal Server Error) response. The behavior is now updated to return the correct HTTP 403 (Forbidden) status code when such limits are exceeded, as per service expectations.

Changes

• Updated the handling of KapuaMaxNumberOfItemsReachedException to ensure it maps to a 403 status code instead of 500.
• Ensured consistent behavior when the maximum allowed limit is exceeded for all entity types.
• Enhanced error information to include entity-specific details (entityType) for better traceability and debugging.

Why this is important

The previous 500 response indicated a server-side error, which led to confusion and misalignment with the intended service behavior. These changes ensure that exceeding service-defined limits is appropriately flagged as a client-side issue (403 Forbidden), improving correctness and reliability of APIs.

How to reproduce the original issue

1. Attempt to create entities (e.g., users) until the service-defined maximum limit is reached.
2. Observe the server responding with HTTP 500 instead of 403.

Expected Behavior After Fix

• When the limit is exceeded, the response is now HTTP 403 (Forbidden) with clear error details that include relevant entity information.

[codecov]

Codecov Report

Attention: Patch coverage is 0% with 15 lines in your changes missing coverage. Please review.

Project coverage is 16.76%. Comparing base (38c4367) to head (ea95f48).
Report is 16 commits behind head on develop.

Files with missing lines	Patch %	Lines
...s/KapuaMaxNumberOfItemsReachedExceptionMapper.java	0.00%	9 Missing ⚠️
...l/errors/MaxNumberOfItemsReachedExceptionInfo.java	0.00%	6 Missing ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             develop    #4154      +/-   ##
=============================================
- Coverage      16.79%   16.76%   -0.04%     
  Complexity        22       22              
=============================================
  Files           2037     2039       +2     
  Lines          52835    52850      +15     
  Branches        4441     4441              
=============================================
- Hits            8874     8860      -14     
- Misses         43560    43587      +27     
- Partials         401      403       +2     

Files with missing lines	Coverage Δ
...l/errors/MaxNumberOfItemsReachedExceptionInfo.java	0.00% <0.00%> (ø)
...s/KapuaMaxNumberOfItemsReachedExceptionMapper.java	0.00% <0.00%> (ø)

... and 3 files with indirect coverage changes