Aspose.Cells Cloud – Преобразование рабочей книги Excel в PDF, CSV, HTML и другие форматы (GET /cells/{name})
Этот REST API позволяет получить рабочую книгу Excel в другом формате.
API GetWorkBook
GET https://api.aspose.cloud/v3.0/cells/{name}
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.
Параметры запроса
| Имя параметра | Тип | Описание | Значение по умолчанию |
|---|---|---|---|
| format | string | Целевой формат файла (например, CSV, XLS, HTML, MHTML, ODS, PDF, XML, TXT, TIFF, XLSB, XLSM, XLSX, XLTM, XLTX, XPS, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG и др.). | – |
| password | string | Пароль, необходимый для открытия файла Excel. | – |
| isAutoFit | bool | Автоматически подгоняет ширину строк и столбцов. | false |
| onlySaveTable | bool | Если true, сохраняются только данные таблицы. Принимает значения true или false. |
false |
| outPath | string | Путь для сохранения результата. Для одного файла укажите имя файла и расширение; для нескольких файлов — только папку. | – |
| outStorageName | string | Имя хранилища, в котором будет сохранен выходной файл. | – |
| checkExcelRestriction | bool | Проверка ограничений Excel при изменении ячеек или связанных объектов. | false |
| region | string | Региональные настройки, применяемые к рабочей книге. | – |
| pageWideFitOnPerSheet | bool | Подгоняет ширину страницы под ширину каждого листа при преобразовании в PDF. | false |
| pageTallFitOnPerSheet | bool | Подгоняет высоту страницы под высоту каждого листа при преобразовании в PDF. | false |
| onePagePerSheet | bool | Генерирует по одной странице PDF для каждого листа. | false |
| folder | string | Путь к папке с исходной рабочей книгой. | – |
| storageName | string | Имя хранилища, в котором находится исходный файл. | – |
Ответ
Успех (200)
-
Если параметр запроса
formatне указан, API возвращает объект Workbook, содержащий информацию о структуре рабочей книги. -
Если параметр запроса
formatуказывает тип файла, API возвращает преобразованный файл в запрошенном формате.
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456
(двоичные данные PDF)
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (Успех) | Фильтр применён успешно; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый формат файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий токен JWT. |
| 413 | Payload Too Large (Слишком большой payload) | Загруженный файл превышает предельный размер. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Примечания:
- Преобразование больших рабочих книг может занять больше времени; рекомендуется увеличить таймаут запроса.
- Некоторые форматы (например,
ODS) не поддерживают определённые функции Excel, такие как макросы.
Как использовать API GetWorkBook с SDK
Требования:
- Действующий JWT-токен доступа, полученный в процессе аутентификации Aspose.Cells.
- Исходная рабочая книга должна быть размещена в поддерживаемом хранилище Aspose или передана непосредственно в запросе.
- Убедитесь, что версия API (
v3.0) соответствует последней выпущенной версии.
Спецификация API GetWorkBook
Спецификация OpenAPI определяет публично доступный программный интерфейс и позволяет выполнять REST-взаимодействия прямо из веб-браузера.
Пример запроса
Вы можете использовать инструмент командной строки cURL для доступа к веб-сервисам Aspose.Cells. Следующий пример показывает корректный GET-запрос с обязательным заголовком авторизации.
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ разработки. SDK скрывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Следующие примеры кода показывают, как вызывать веб-сервисы Aspose.Cells с помощью различных SDK:
См. также
Последнее обновление: 2024-12-01