Add Top 10 Filter to an Excel Worksheet (Aspose.Cells Cloud)
This REST API filters the Top 10 items in a list.
REST API
PUT http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filterTop10
The request parameters are:
| Parameter Name | Type | Location | Required | Default | Description |
|---|---|---|---|---|---|
| name | string | path | Yes | — | The name of the Excel file. |
| sheetName | string | path | Yes | — | The name of the worksheet that contains the data. |
| range | string | query | Yes | — | The cell range to which the filter is applied (e.g., A1:B10). |
| fieldIndex | integer | query | Yes | — | Zero‑based index of the column on which the filter is applied. |
| isTop | boolean | query | Yes | true |
true to filter the top items; false for bottom items. |
| isPercent | boolean | query | No | false |
true to treat itemCount as a percentage; false for an absolute count. |
| itemCount | integer | query | No | 10 |
Number of items to include in the filter. |
| matchBlanks | boolean | query | No | false |
true to include blank cells in the filter results. |
| refresh | boolean | query | No | false |
true to refresh the filter after applying it. |
| folder | string | query | No | — | The folder in storage where the Excel file is located. |
| storageName | string | query | No | — | The name of the Aspose Cloud storage. |
The OpenAPI Specification defines a publicly accessible programming interface and lets you perform REST interactions directly from a web browser.
You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to call the API with cURL.
Common HTTP Status Codes
| Code | Meaning | Suggested Fix |
|---|---|---|
| 200 | Success | – |
| 400 | Bad Request | Verify required parameters and their formats. |
| 401 | Unauthorized | Provide a valid JWT token; check token expiration. |
| 404 | Not Found | Ensure the file and worksheet exist in the specified folder/storage. |
| 500 | Internal Server Error | Retry later or contact Aspose support with the request ID. |
Cloud SDK Family
Using an SDK is the fastest way to develop. An SDK handles low‑level details so you can focus on your project. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.
The following code examples demonstrate how to call Aspose.Cells web services using various SDKs:
Author: Aspose.Cells Cloud product team (10+ years of spreadsheet automation experience)
Last updated: 2024‑12‑01