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

Этот REST API добавляет новую строку в рабочий лист Excel. Он вставляет пустую строку по указанному индексу (начинается с нуля).

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

В заголовке Authorization должен быть указан действующий токен доступа Aspose Cloud (Bearer JWT).
Целевая рабочая книга должна быть загружена в облачное хранилище Aspose Cloud, а параметры folder и storageName должны указывать на её расположение.

Примечания:

Индекс строки (rowIndex) нумеруется с нуля; вставка по индексу 0 добавляет строку в начало рабочего листа.
Максимальное количество строк в рабочем листе Excel составляет 1 048 576; попытка вставить строку за пределами этого лимита приведёт к

PutInsertWorksheetRow API

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

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

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

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

Имя параметра	Тип	Местоположение	Описание
name	string	path	Имя файла рабочей книги.
sheetName	string	path	Имя рабочего листа.
rowIndex	integer	path	Нулевой индекс, по которому будет вставлена новая строка.
folder	string	query	Путь к папке в хранилище, где находится рабочая книга.
storageName	string	query	Имя облачного хранилища Aspose Cloud, которое следует использовать.

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

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

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Примечание: Все конечные точки Aspose.Cells Cloud используют HTTPS. Для рабочих вызовов используйте защищённую схему https://.

Ответ

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

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

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

Пример ответа об ошибке (например, если индекс строки выходит за пределы допустимого диапазона):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Индекс строки вне допустимого диапазона. Максимально допустимое количество строк: 1048576."
}

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

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

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