Сохранение рабочей книги Excel – Aspose.Cells Cloud API

Этот REST API позволяет сохранить файл Excel в различных форматах.
Перед вызовом этого конечного пункта убедитесь, что у вас есть действительный токен доступа OAuth 2.0 и что исходная рабочая книга хранится в вашем облачном хранилище Aspose.

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

Получите JWT-токен доступа и включите его в заголовок Authorization: Bearer <token> каждого запроса.
Загрузите исходную рабочую книгу в облачное хранилище Aspose (или подтвердите её существование).
Знайте имя хранилища и путь к папке, в которой находится рабочая книга.

API PostWorkbookSaveAs

POST https://api.aspose.cloud/v3.0/cells/{name}/saveAs

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

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

Параметр пути

Имя параметра	Тип	Описание
name	string	Имя файла Excel.

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

Имя параметра	Тип	Описание
newfilename	string	Новое имя файла сохраняемого документа.
isAutoFitRows	string	Если `true`, автоматически подстраивает высоту всех строк в рабочей книге. По умолчанию — `false`.
isAutoFitColumns	string	Если `true`, автоматически подстраивает ширину столбцов в рабочей книге. По умолчанию — `false`.
folder	string	Папка, содержащая исходную рабочую книгу.
storageName	string	Имя хранилища, в котором находится исходный файл.
outStorageName	string	Имя хранилища, в котором будет сохранён выходной файл.
checkExcelRestriction	bool	Указывает, следует ли применять ограничения Excel при изменении ячеек или связанных объектов.
region	string	Региональные настройки, применяемые к рабочей книге.
pageWideFitOnPerSheet	bool	Подгонять ширину страницы под каждую рабочую лист при преобразовании.
pageTallFitOnPerSheet	bool	Подгонять высоту страницы под каждую рабочую лист при преобразовании.
sheetName	string	Имя рабочего листа для преобразования.
pageIndex	string	Индекс страницы для преобразования в указанном рабочем листе (требуется `sheetName`).
onePagePerSheet	bool	При преобразовании в PDF генерировать по одной странице на рабочий лист.

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

Имя параметра	Тип	Описание
SaveOptions	Object	Параметры сохранения, передаваемые во второй части multipart-запроса.

Пример тела запроса (JSON-часть multipart-запроса)

{
  "SaveOptions": {
    "SaveFormat": "pdf",
    "CompressionLevel": 9
  }
}

Ответ

API возвращает объект SaveResponse.

{
  "Status": "OK",
  "Code": 200,
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  }
}

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

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

Как использовать API PostWorkbookSaveAs с SDK

Спецификация API PostWorkbookSaveAs

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

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

Запрос

curl -X POST "https://api.aspose.cloud/v3.0/cells/sampleBook.xlsx/SaveAs?newfilename=sample.pdf&isAutoFitRows=true&isAutoFitColumns=true" \
  -H "accept: multipart/form-data" \
  -H "Authorization: Bearer <ваш_jwt_токен>"

Ответ

{
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Использование SDK Aspose.Cells Cloud

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

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

Для других сценариев преобразования см. руководства Преобразование Excel в PDF и Экспорт Excel в CSV.

Конвертирование Excel в HTML Расширенное преобразование файла Excel