Экспорт рабочего листа Excel в различные форматы – Aspose.Cells Cloud

Вы можете экспортировать рабочий лист в следующие форматы:

Ознакомьтесь с другими операциями экспорта, например, экспортом всей книги или диаграммы.

API PostExport

POST https://api.aspose.cloud/v3.0/cells/export

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.

Параметры запроса

Имя параметра Тип Путь/Строка запроса/HTTP-тело Обязательный Описание
file file formData Да Файл для загрузки
objectType string query Да Тип объекта для экспорта. Для экспорта диаграммы используйте chart. Другие возможные значения: worksheet, picture и т.д.
format string query Да Желаемый выходной формат. Поддерживаемые значения: png, jpeg, gif, bmp, svg, tiff, emf, wmf, pdf.

Ответ

{
  "Files": [
    {
      "Filename": "Book1_xlsx_Sheet1.tif",
      "FileSize": 390,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet2.tif",
      "FileSize": 10040,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet3.tif",
      "FileSize": 2824,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet4.tif",
      "FileSize": 1350,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet5.tif",
      "FileSize": 12978,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet6.tif",
      "FileSize": 7002,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet7.tif",
      "FileSize": 11532,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet1.tif",
      "FileSize": 382,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet2.tif",
      "FileSize": 382,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet3.tif",
      "FileSize": 130084,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet4.tif",
      "FileSize": 120062,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Обработка ошибок

В случае ошибки запроса API возвращает объект JSON с ошибкой, содержащий поля, такие как Code и Message. Типичные HTTP-коды состояния включают 401 Unauthorized (отсутствующий или недействительный токен) и 400 Bad Request (некорректные параметры).

HTTP-коды состояния

Код Значение Описание
200 OK (OK) Фильтр успешно применён; ответ содержит данные операции.
400 Bad Request (Неверный запрос) Отсутствующие или некорректные параметры (например, неподдерживаемый тип файла).
401 Unauthorized (Неавторизовано) Неверный или отсутствующий JWT-токен.
413 Payload Too Large (Слишком большой полезный груз) Загруженный файл превышает ограничение по размеру.
500 Internal Server Error (Внутренняя ошибка сервера) Непредвиденная ошибка сервера.

Примечания

  • Максимальный размер файла для загрузки: 50 МБ.
  • API поддерживает экспорт нескольких рабочих листов в одном запросе; каждый рабочий лист возвращается как отдельный файл в массиве Files.
  • Для больших книг доступна асинхронная обработка; используйте ответ 202 Accepted для опроса статуса операции.

Как использовать API PostExport с SDK

Предварительные требования

Перед вызовом API получите действительный JWT-токен доступа, используя процесс аутентификации Aspose.Cells Cloud. Убедитесь, что токен включён в заголовок Authorization каждого запроса. SDK автоматически обрабатывают получение токена при настройке с вашими учётными данными клиента.

Спецификация API PostExport

OpenAPI-спецификация определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия напрямую из веб-браузера.

Вы можете использовать инструмент командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример демонстрирует вызов Cloud API с помощью cURL.

# Экспорт рабочего листа в формат TIFF
curl -X POST "https://api.aspose.cloud/v3.0/cells/export?objectType=worksheet&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=@MyWorkbook.xlsx"

Использование SDK Aspose.Cells Cloud

Использование SDK — самый быстрый способ разработки под Aspose.Cells Cloud. SDK абстрагирует низкоуровневые детали, позволяя сосредоточиться на бизнес-логике. Полный список поддерживаемых SDK доступен на репозитории GitHub.

Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Импорт пакетных данных в лист Excel Импорт целочисленного массива в рабочую тетрадь Excel