Необходимые условия: Перед вызовом этого API необходимо получить действительный JWT-токен, убедиться, что целевая рабочая книга загружена в указанный хранилище, и иметь необходимые права доступа к файлу. Для примеров командной строки рекомендуется использовать последнюю версию cURL (7.68 или выше).
Этот REST API добавляет фильтр для определённого столбца на листе Excel.
API PutWorksheetFilter
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filter
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | Path | Имя рабочей книги. |
| sheetName | string | Path | Имя листа. |
| range | string | Query | Диапазон ячеек, содержащий фильтр (например, A1:B1). |
| fieldIndex | integer | Query | Индекс столбца (начиная с нуля), к которому применяется фильтр. |
| criteria | string | Query | Критерий фильтрации (например, значение или выражение). |
| matchBlanks | boolean | Query | Установите значение true, чтобы включить пустые ячейки в фильтр; иначе false. |
| refresh | boolean | Query | Установите значение true, чтобы обновить фильтр после применения; иначе false. |
| folder | string | Query | Папка, в которой хранится исходная рабочая книга. |
| storageName | string | Query | Имя сервиса хранилища. |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит сведения о выполнении операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой полезный载荷) | Загруженный файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PutWorksheetFilter с SDK
Спецификация API PutWorksheetFilter
Спецификация OpenAPI определяет общедоступный программный интерфейс, позволяющий выполнять REST-взаимодействия непосредственно из веб-браузера.
Для удобного доступа к веб-сервисам Aspose.Cells Cloud вы можете использовать утилиту командной строки cURL. В следующем примере показано, как вызвать API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ разработки. SDK обрабатывает низкоуровневые детали, позволяя вам сосредоточиться на проекте. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Приведённые ниже примеры кода демонстрируют вызов веб-сервисов Aspose.Cells Cloud с использованием различных SDK: