diff --git a/app/Http/Controllers/Apis/Marketplace/PrivateCloudsApiController.php b/app/Http/Controllers/Apis/Marketplace/PrivateCloudsApiController.php index ecaa9e41f..19eda7785 100644 --- a/app/Http/Controllers/Apis/Marketplace/PrivateCloudsApiController.php +++ b/app/Http/Controllers/Apis/Marketplace/PrivateCloudsApiController.php @@ -1,4 +1,5 @@ -value. Available fields: name, company. Operators: =@ (starts with), == (equals), @@ (contains).', + style: 'form', + explode: true, + schema: new OA\Schema( + type: 'array', + items: new OA\Items(type: 'string', example: 'name@@cloud') + ) + ), + new OA\Parameter( + name: 'order', + in: 'query', + required: false, + description: 'Order by field(s). Available fields: id, name. Use "-" prefix for descending order.', + schema: new OA\Schema(type: 'string', example: 'name,-id') + ), + new OA\Parameter( + name: 'expand', + in: 'query', + required: false, + description: 'Comma-separated list of related resources to include. Available relations: company, type, capabilities, guests, hypervisors, supported_regions, data_centers, data_center_regions', + schema: new OA\Schema(type: 'string', example: 'company,data_centers') + ), + new OA\Parameter( + name: 'relations', + in: 'query', + required: false, + description: 'Relations to load eagerly', + schema: new OA\Schema(type: 'string', example: 'company,data_centers') + ), + new OA\Parameter( + name: 'fields', + in: 'query', + required: false, + description: 'Comma-separated list of fields to return', + schema: new OA\Schema(type: 'string', example: 'id,name,company.name') + ), + ], + responses: [ + new OA\Response( + response: Response::HTTP_OK, + description: 'Success - Returns paginated list of hosted private clouds', + content: new OA\JsonContent(ref: '#/components/schemas/PaginatedPublicOrPrivateCloudsResponse') + ), + new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error"), + new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error") + ] + )] public function getAll() { return parent::getAll(); } -} \ No newline at end of file +}