Экспорт листа с помощью Aspose.Cells Cloud API — форматы, примеры cURL и SDK
Этот REST API позволяет экспортировать лист из файла Excel в множество различных форматов файлов.
Краткое описание — используйте endpoint Get Worksheet для загрузки одного листа из рабочей книги в выбранном вами формате.
Вы можете экспортировать в следующие форматы:
| Формат | Расширение | MIME-тип |
|---|---|---|
| XLS | .xls | application/vnd.ms-excel |
| XLSX | .xlsx | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| XLSB | .xlsb | application/vnd.ms-excel.sheet.binary.macroEnabled.12 |
| CSV | .csv | text/csv |
| TSV | .tsv | text/tab-separated-values |
| XLSM | .xlsm | application/vnd.ms-excel.sheet.macroEnabled.12 |
| ODS | .ods | application/vnd.oasis.opendocument.spreadsheet |
| TXT | .txt | text/plain |
| application/pdf | ||
| OTS | .ots | application/vnd.oasis.opendocument.spreadsheet-template |
| XPS | .xps | application/vnd.ms-xpsdocument |
| DIF | .dif | application/x-dif |
| PNG | .png | image/png |
| JPEG | .jpeg | image/jpeg |
| GIF | .gif | image/gif |
| BMP | .bmp | image/bmp |
| WMF | .wmf | image/wmf |
| TIFF | .tiff | image/tiff |
| EMF | .emf | image/emf |
| NUMBERS | .numbers | application/vnd.apple.numbers |
| FODS | .fods | application/vnd.oasis.opendocument.spreadsheet-flat-xml |
Безопасность и аутентификация
Aspose.Cells Cloud API безопасны и требуют аутентификации по токену JWT.
REST API
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Обязательный. Имя файла Excel. |
| sheetName | string | path | Обязательный. Имя листа, который требуется экспортировать. |
| format | string | query | Целевой формат файла для экспортируемого листа (например, pdf, png). |
| verticalResolution | integer | query | Разрешение изображения в DPI для форматов, поддерживающих разрешение (например, PNG, JPEG). |
| horizontalResolution | integer | query | Разрешение изображения в DPI для форматов, поддерживающих разрешение. |
| area | string | query | Диапазон ячеек для экспорта (например, A1:D10). |
| pageIndex | integer | query | Индекс страницы для экспорта, если лист разбит на страницы. |
| folder | string | query | Путь к папке в хранилище, где расположен исходный файл. |
| storageName | string | query | Имя хранилища Aspose Cloud. |
Спецификация OpenAPI определяет публично доступное программное интерфейсное API и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример демонстрирует, как вызвать Cloud API с помощью cURL.
Обработка ошибок
API возвращает стандартные HTTP-коды состояния. Распространённые ответы включают:
| Код состояния | Значение | Пример JSON-тела ответа |
|---|---|---|
| 200 | Успех — поток листа возвращён. | { "stream": "..." } |
| 400 | Неверный запрос — отсутствующие или некорректные параметры. | { "error": "Неверный параметр формата." } |
| 401 | Неавторизован — недействительный или отсутствующий токен JWT. | { "error": "Ошибка аутентификации." } |
| 404 | Не найдено — указанный файл или лист не существует. | { "error": "Лист не найден." } |
| 500 | Внутренняя ошибка сервера — непредвиденное состояние сервера. | { "error": "Непредвиденная ошибка." } |
Обрабатывайте эти ответы в клиентском коде, чтобы предоставить пользователям соответствующую обратную связь.
Семейство облачных SDK
Использование SDK — это лучший способ ускорить разработку. SDK берёт на себя обработку низкоуровневых деталей и позволяет сосредоточиться на задачах вашего проекта. Ознакомьтесь со репозиторием на GitHub, чтобы получить полный список SDK Aspose.Cells Cloud.
Следующие примеры кода демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK: