Автоподбор высоты нескольких строк в рабочей книге Excel – Документация API Aspose.Cells Cloud

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

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

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

REST API

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

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

Имя параметра	Тип	Местоположение	Описание	Обязательный
name	string	path	Имя файла Excel.	✔
sheetName	string	path	Имя рабочего листа.	✔
autoFitterOptions	object	body	Параметры, управляющие тем, как выполняется автоподбор строк (например, игнорировать скрытые строки). См. краткое описание полей ниже.	✖
startRow	integer	query	Номер первой строки для автоподбора (индексация с 1).	✔
endRow	integer	query	Номер последней строки для автоподбора (включительно).	✔
onlyAuto	boolean	query	Если `true`, API изменяет только те строки, высота которых автоматически вычисляется в Excel. Если `false`, выполняется полный автоподбор.	✖
folder	string	query	Папка, содержащая документ.	✖
storageName	string	query	Имя сервиса хранилища.	✖

Поля autoFitterOptions (все необязательны):

AutoFitMergedCells (boolean) – Если true, объединённые ячейки учитываются при расчёте высоты строки.
IgnoreHidden (boolean) – Если true, скрытые строки игнорируются в процессе автоподбора.
OnlyAuto (boolean) – Отражает значение параметра запроса onlyAuto; при установке переопределяет значение параметра запроса.

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

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

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitrows?startRow=1&endRow=7" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"AutoFitMergedCells": true, "IgnoreHidden": true, "OnlyAuto": false}'

Ответ

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

Типичные ответы об ошибках:

400 Bad Request – Некорректные значения параметров или повреждённое тело JSON.
401 Unauthorized – Отсутствует или недействителен токен JWT.
404 Not Found – Указанный файл или рабочий лист не существует.
500 Internal Server Error – Возникла непредвиденная ошибка сервера.

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

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

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

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

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

Автоматическая подгонка строки в рабочей книге Excel