Группировка строк в рабочем листе Excel с помощью API Aspose.Cells Cloud

Этот REST API позволяет выполнить группировку строк в рабочем листе Excel.

Необходимые условия:

В заголовке Authorization должен быть предоставлен действительный токен доступа OAuth 2.0 (Bearer JWT).
Рабочая книга должна уже существовать в указанной папке выбранного storageName (или в хранилище по умолчанию) до отправки запроса.

API PostGroupWorksheetRows

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/group

Безопасность и аутентификация

Aspose.Cells Cloud API защищены и требуют аутентификацию по токену JWT.

Параметры запроса

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла рабочей книги.
sheetName	string	path	Имя рабочего листа.
firstIndex	integer	query	Нулевой индекс первой строки, включаемой в группу.
lastIndex	integer	query	Нулевой индекс последней строки, включаемой в группу.
hide	boolean	query	Указывает, должны ли быть скрыты сгруппированные строки (`true` или `false`).
folder	string	query	Путь к папке, содержащей рабочую книгу.
storageName	string	query	Имя хранилища, в котором находится рабочая книга.

Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять взаимодействие с REST непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как выполнять вызовы в облачный API с помощью cURL.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/group?firstIndex=1&lastIndex=2&hide=true" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Коды HTTP-статуса

Код	Значение	Описание
200	OK (ОК)	Фильтр успешно применён; в ответе содержатся подробности операции.
400	Bad Request (Неверный запрос)	Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла).
401	Unauthorized (Неавторизован)	Недействительный или отсутствующий JWT-токен.
413	Payload Too Large (Слишком большой payload)	Загружаемый файл превышает лимит размера.
500	Internal Server Error (Внутренняя ошибка сервера)	Непредвиденная ошибка сервера.

Типичные сообщения об ошибках:

400 Bad Request – убедитесь, что firstIndex и lastIndex являются допустимыми целыми числами и что firstIndex ≤ lastIndex.
401 Unauthorized – проверьте, содержит ли заголовок Authorization актуальный JWT-токен.
404 Not Found – убедитесь, что рабочая книга (name) и рабочий лист (sheetName) существуют в указанной папке/storageName.

Семейство облачных SDK

Использование SDK — лучший способ ускорить разработку. SDK берёт на себя обработку низкоуровневых деталей, позволяя вам сосредоточиться на задачах проекта. Полный список облачных SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Примеры кода ниже демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Получение одной строки из рабочего листа Excel с использованием API Aspose.Cells Cloud Отгруппировка строк на листе Excel