Преобразование листа в PDF, PNG, CSV и другие форматы – Aspose.Cells Cloud API
API для преобразования листов — конечная точка GET /cells/{name}/worksheets/{sheetName} преобразует отдельный лист (лист внутри рабочей книги Excel) в другой файловый формат.
Необходимое условие: Перед вызовом данной конечной точки у вас должен быть действительный JWT-токен и рабочая книга, сохранённая в поддерживаемом хранилище Aspose Cloud.
Поддерживаемые импортируемые форматы (из которых можно считать лист):
- XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT
Поддерживаемые только для экспорта форматы (в которые можно сохранить лист):
- PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS
REST API
Спецификация OpenAPI описывает публично доступный интерфейс.
Параметры запроса
| Параметр | Тип | Обязательный | Значение по умолчанию | Допустимые значения | Описание |
|---|---|---|---|---|---|
| format | string | Да | – | pdf, png, jpeg, bmp, svg, tiff, emf, csv, txt, … (см. поддерживаемый список) | Целевой формат вывода. |
| verticalResolution | integer | Нет | 96 | 72‑600 | Вертикальное разрешение (DPI) для вывода изображения. |
| horizontalResolution | integer | Нет | 96 | 72‑600 | Горизонтальное разрешение (DPI) для вывода изображения. |
| password | string | Нет | – | – | Пароль для открытия защищённой рабочей книги. |
| folder | string | Нет | – | – | Облачная папка, в которой хранится исходная рабочая книга. |
| storage | string | Нет | – | – | Имя хранилища (например, «Default»). |
Ответ
| Код статуса | Описание | Тип возвращаемых данных |
|---|---|---|
| 200 | Преобразование успешно завершено; возвращается двоичный поток преобразованного файла. | application/octet-stream |
| 400 | Неверный запрос — отсутствуют или недопустимы параметры. | Объект ошибки JSON |
| 401 | Неавторизованный доступ — недействительный или отсутствующий JWT-токен. | Объект ошибки JSON |
| 404 | Не найдено — рабочая книга или лист не существуют. | Объект ошибки JSON |
| 500 | Внутренняя ошибка сервера — непредвиденное завершение. | Объект ошибки JSON |
Пример запроса (cURL)
curl -v "https://api.aspose.com/v3.0/cells/myWorkbook.xlsx/worksheets/Sheet1?format=png&verticalResolution=96&horizontalResolution=96" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
Пример ответа
Преобразованное изображение (двоичный поток)
Семейство облачных SDK
Использование SDK — самый быстрый способ разработки. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на вашем проекте. Полный список облачных SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Приведённые ниже примеры кода демонстрируют вызов веб-служб Aspose.Cells с использованием различных SDK: