Экспорт объектов диаграмм из рабочей книги Excel в различные форматы изображений и документов — распространённая задача при создании отчётов и публикации контента. Aspose.Cells Cloud предоставляет простой REST-эндпоинт для прямого преобразования диаграмм в популярные форматы, такие как PNG, JPEG, PDF, SVG, TIFF, EMF, WMF и другие.
Вы можете экспортировать диаграммы в следующие форматы: PNG, GIF, JPEG, BMP, SVG, TIFF, EMF, WMF, и PDF.
Необходимые условия:
- Действующая учётная запись Aspose.Cells Cloud с активной подпиской.
- OAuth 2.0 Bearer-токен (JWT), полученный в процессе аутентификации.
- Файл рабочей книги для загрузки (максимальный размер — менее 50 МБ).
REST API
POST https://api.aspose.cloud/v3.0/cells/export
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.
Параметры запроса
| Название параметра | Тип | Путь / строка запроса / тело HTTP-запроса | Обязательный | Описание |
|---|---|---|---|---|
| file | файл | formData | Да | Файл для загрузки |
| objectType | строка | query | Да | Тип экспортируемого объекта. Для экспорта диаграмм используйте chart. Другие возможные значения: worksheet, picture и т.д. |
| format | строка | query | Да | Желаемый выходной формат. Поддерживаемые значения: png, jpeg, gif, bmp, svg, tiff, emf, wmf, pdf. |
Ответ
{
"Files": [
{
"Filename": "Book1_xlsx_Sheet4_Charts_0.tif",
"FileSize": 10040,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_1.tif",
"FileSize": 12978,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_2.tif",
"FileSize": 7002,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_3.tif",
"FileSize": 11532,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet6_Charts_0.tif",
"FileSize": 8270,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_0.tif",
"FileSize": 42570,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_1.tif",
"FileSize": 12102,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_2.tif",
"FileSize": 8290,
"FileContent": "-----Base64String--------"
}
]
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (OK) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой payload) | Загружаемый файл превышает лимит размера. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PostExport с SDK
Спецификация API PostExport
Спецификация OpenAPI определяет публично доступное программное интерфейсное решение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Все запросы должны содержать действующий OAuth 2.0 Bearer-токен в заголовке Authorization. Пример ниже демонстрирует вызов API с помощью cURL и загрузку рабочей книги с использованием multipart/form‑data.
curl -X POST "https://api.aspose.cloud/v3.0/cells/export?objectType=chart&format=tiff" \
-H "Authorization: Bearer {access_token}" \
-H "Accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-F "File=@/path/to/your/workbook.xlsx"
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: