Feature | Extend Swagger Coverage for controller PrivateCloudsApiController

[matiasperrone-exo]

Task:

Ref: https://app.clickup.com/t/86b6wkg8t

Depends on PR #362

[caseylocker]

@smarcet This has been tested along with #362 and passed. Please merge.

[caseylocker]

Still needs work.

• Expand on the 'order' parameter description.

description: 'Order by field(s). Available fields: id, name. Use "-" prefix for descending order.',

• Missing pagination parameters (page, per_page). Add 'page' and 'per_page' parameters to the controller

Example:

new OA\Parameter(
    name: 'page',
    in: 'query',
    required: false,
    description: 'Page number for pagination',
    schema: new OA\Schema(type: 'integer', example: 1)
),
new OA\Parameter(
    name: 'per_page',
    in: 'query',
    required: false,
    description: 'Items per page',
    schema: new OA\Schema(type: 'integer', example: 10, maximum: 100)
),

• Enhance filter operator descriptions (=@ means "starts with", etc.)

...Operators: == (equals), =@ (starts with), @@ (contains).',

• Clarify expand parameter behavior (what gets replaced on expansion.)

[matiasperrone-exo]

All the requested changes were introduced. I don't understand what is missing.

[caseylocker]

Replace response: 200 with response: Response::HTTP_OK then it should be good to go.

[caseylocker]

Approved

[smarcet]

LGTM