Экспорт страницы рабочего листа – Справочник по API Aspose.Cells Cloud
Экспорт конкретной страницы рабочего листа полезен, когда вам нужен печатный снимок отчета, изображения графика или выдержки из данных без загрузки всей книги. Этот endpoint позволяет получить отдельную страницу в формате, наилучшим образом соответствующем вашему последующему рабочему процессу.
API GET /cells/{name}/worksheets/{sheetName} позволяет преобразовать указанную страницу рабочего листа в различные форматы файлов. Поддерживаемые форматы: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT, PDF, OTS, XPS, DIF, PNG, JPEG, GIF, BMP, WMF, TIFF, EMF, NUMBERS, FODS.
REST API
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять взаимодействие REST напрямую из веб-браузера.
Необходимые условия – У вас должен быть действующий токен аутентификации JWT и книга, сохранённая в облачной папке, указанной с помощью параметра
folder.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как выполнить вызов облачного API с помощью cURL.
Параметры
| Параметр | Тип | Описание | По умолчанию |
|---|---|---|---|
format |
string | Выходной формат файла (например, pdf, png, csv). |
pdf |
verticalResolution |
integer | Вертикальное разрешение рендеримого изображения в DPI. | 100 |
horizontalResolution |
integer | Горизонтальное разрешение рендеримого изображения в DPI. | 100 |
pageIndex |
integer | Индекс страницы рабочего листа для экспорта (начиная с нуля; 0 — первая страница). |
0 |
folder |
string | Папка облачного хранилища, где находится исходная рабочая книга. | — |
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Недействительный или отсутствующий токен JWT. |
| 413 | Payload Too Large (Слишком большой payload) | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка на стороне сервера. |
Возможные ошибки
- 401 Unauthorized (Неавторизован) – Недействительный или отсутствующий токен JWT.
- 404 Not Found (Не найдено) – Указанная рабочая книга или рабочий лист не существует.
- 400 Bad Request (Неверный запрос) – Недопустимое значение параметра (например, неподдерживаемое значение
format). - 500 Internal Server Error (Внутренняя ошибка сервера) – Непредвиденная проблема на стороне сервера.
Семейство облачных SDK
Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список облачных SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Примеры кода ниже демонстрируют, как вызывать веб-сервисы Aspose.Cells Cloud с использованием различных SDK: