Добавление объекта списка (таблицы) в рабочий лист Excel – Документация Aspose.Cells Cloud
Этот REST API добавляет объект списка (таблицу) в рабочий лист Excel.
Прежде чем использовать этот endpoint, убедитесь, что у вас есть действительный JWT-токен, книга хранится в поддерживаемом облачном хранилище и указанный рабочий лист существует.
REST API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя файла книги. |
| sheetName | string | path | Имя рабочего листа. |
| startRow | integer | query | Индекс первой строки диапазона таблицы (начинается с 0). |
| startColumn | integer | query | Индекс первого столбца диапазона таблицы (начинается с 0). |
| endRow | integer | query | Индекс последней строки диапазона таблицы (начинается с 0). |
| endColumn | integer | query | Индекс последнего столбца диапазона таблицы (начинается с 0). |
| hasHeaders | boolean | query | true, если первая строка содержит заголовки столбцов; иначе false. |
| listObject | object | body | Описание объекта списка (см. Схему тела запроса). |
| folder | string | query | Папка, содержащая книгу. |
| storageName | string | query | Имя хранилища. |
Схема тела запроса
Объект listObject описывает таблицу, которая будет создана. Приведены только наиболее распространённые свойства; полный список смотрите в спецификации OpenAPI.
{
"displayName": "MyTable",
"showTotals": false,
"style": "TableStyleMedium2"
}
Пример запроса (cURL)
curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects?startRow=1&startColumn=1&endRow=10&endColumn=12&hasHeaders=true" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-d '{
"displayName": "MyTable",
"showTotals": false,
"style": "TableStyleMedium2"
}'
Пример ответа
{
"Code": 200,
"Status": "OK"
}
Коды ошибок
| HTTP-статус | Причина | Описание |
|---|---|---|
| 400 | Bad Request | Неверные параметры диапазона или некорректный JSON в теле. |
| 401 | Unauthorized | Отсутствует или истёк JWT-токен. |
| 404 | Not Found | Указанная книга или рабочий лист не существуют. |
| 500 | Internal Server Error | Непредвиденная ошибка на стороне сервера. |
Пример ответа 400
{
"Code": 400,
"Status": "Bad Request",
"Message": "Invalid range parameters."
}
Пример ответа 401
{
"Code": 401,
"Status": "Unauthorized",
"Message": "Authentication token is missing or expired."
}
Полное описание этой операции приведено в спецификации OpenAPI.
Семейство облачных SDK
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали и позволяет сосредоточиться на задачах проекта. Полный список облачных SDK Aspose.Cells Cloud см. в репозитории GitHub.
В приведённых ниже примерах кода показано, как выполнять вызовы веб-сервисов Aspose.Cells с помощью различных SDK: