Enhance /api/v1/categories/children Endpoint to Return Parent List

[oidacra]

Parent Issue

#28493

User Story

As a developer, I need the /api/v1/categories/children endpoint to return the parentList of categories when showChildrenCount: true is sent. Alternatively, create a new parameter to handle this. This is necessary to provide the path to the parent category for deeper levels (2-N) to help users navigate back to the selected child category.

Acceptance Criteria

• Modify the /api/v1/categories/children endpoint to include the parentList when parentList: true is sent.
• Alternatively, add a new parameter to request the parentList.
• Ensure the parentList provides the complete path to the parent category for deeper levels (2-N).
• Update the API documentation to reflect the changes.
• This is only of 1 Level, only for the children of the inode sent.
• Write unit tests to cover the new functionality.

Proposed Objective

API Enhancement

Proposed Priority

Priority 2 - Important

dotCMS Version

master

Problem

Request don't have parentList

When we sent filter query param, the endpoint retrieve parentList of the category

Assumptions & Initiation Needs

Assuming the current implementation of the /api/v1/categories/children endpoint can be enhanced to include the parentList. Access to the current codebase and API documentation is required.

Quality Assurance Notes & Workarounds

Quality assurance should verify that the parentList is returned correctly when requested and that the API remains stable. Ensure that edge cases, such as categories with no parents, are handled correctly.

[dsilvam]

Passed Internal QA:
This request is properly returning the list of parents

http://localhost:8080/api/v1/categories/children?inode=5d72bea551587a8783e88e9145f4e132&per_page=7000&direction=ASC&showChildrenCount=true&parentList=true

[josemejias11]

Approved: Tested on trunk_a466b5d, Docker, macOS 14.5, FF v126.0.1