Преобразование файла Excel в различные форматы
Перед вызовом этого конечного ponto убедитесь, что вы получили действительный токен JWT и что исходная рабочая книга находится в поддерживаемом хранилище (например, Aspose Cloud Storage). Включите токен в заголовок Authorization, а при необходимости укажите параметр запроса storageName.
Этот REST API преобразует файл Excel в различные выходные форматы.
API PutConvertWorkBook
PUT https://api.aspose.cloud/v3.0/cells/convert
Запрос представляет собой HTTP PUT с многочастным содержимым (см. RFC 2046 или RFC 1341).
Первая часть многочастного тела содержит файл данных, а вторая часть — параметры сохранения.
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе токена JWT.
Параметры запроса
| Имя параметра | Тип | Описание |
|---|---|---|
format |
string | Целевой формат файла (например, CSV, XLS, HTML, PDF, XML, TXT, TIFF, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG и др.). |
password |
string | Пароль, необходимый для открытия исходного файла Excel. |
outPath |
string | Полный путь (включая имя файла и расширение) для одного выходного файла или путь к папке при генерации нескольких файлов. |
storageName |
string | Имя хранилища, в котором находится исходный файл. |
checkExcelRestriction |
bool | Если true, проверяет ограничения Excel перед изменением ячеек или связанных объектов. |
streamFormat |
string | Формат входного потока файла. |
region |
string | Региональные настройки, применяемые к рабочей книге. |
pageWideFitOnPerSheet |
bool | Регулирует ширину страницы под размер каждого листа при преобразовании в PDF. |
pageTallFitOnPerSheet |
bool | Регулирует высоту страницы под размер каждого листа при преобразовании в PDF. |
sheetName |
string | Имя листа для преобразования. |
pageIndex |
string | Индекс страницы для преобразования (требуется sheetName). |
onePagePerSheet |
bool | Если true, генерирует по одной странице PDF на каждый лист. |
AutoRowsFit |
bool | Автоматически подгоняет все строки в рабочей книге. |
AutoColumnsFit |
bool | Автоматически подгоняет ширину столбцов в рабочей книге. |
Параметры тела запроса
| Имя параметра | Тип | Описание |
|---|---|---|
datafile |
data file | Файл Excel, размещенный в первой части многочастного тела. |
SaveOptions |
object | Параметры сохранения, размещенные во второй части тела. |
Ответ
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK | Фильтр успешно применён; ответ содержит сведения о выполненной операции. |
| 400 | Bad Request | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized | Недействительный или отсутствующий токен JWT. |
| 413 | Payload Too Large | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error | Непредвиденная ошибка сервера. |
Как использовать API PutConvertWorkBook с SDK
Спецификация API PutConvertWorkBook
Спецификация OpenAPI определяет открытый интерфейс, позволяющий выполнять прямые REST-взаимодействия из веб-браузера.
Пример cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/convert?format=html" \
-H "accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-d '{"File":{}}'
Использование SDK Aspose.Cells Cloud
Использование SDK ускоряет разработку, позволяя сосредоточиться на бизнес-логике, поскольку низкоуровневые детали обрабатываются SDK. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Следующие примеры кода демонстрируют вызов веб-служб Aspose.Cells с использованием различных SDK: