Расширенное преобразование файла Excel – Руководство по API Aspose.Cells Cloud

Расширенный облачный API для преобразования Excel

Операция «Расширенное преобразование» позволяет преобразовать рабочую книгу Excel в различные выходные форматы (PDF, HTML, CSV и др.), предоставляя точный контроль над настройками страницы, параметрами сохранения и параметрами печати.

Требования / Аутентификация
Для использования данного endpoint необходимо получить токен доступа в Aspose.Cells Cloud и включить его в заголовок Authorization как токен типа Bearer.

Ссылка на API

  • Метод: PUT
  • Endpoint: /cells/convert
  • Параметры:
    • format (строка, обязательный) – Желаемый выходной формат (например, pdf, html).
    • outPath (строка, необязательный) – Путь в облачном хранилище, куда будет сохранён преобразованный файл.
    • options (объект, необязательный) – JSON-объект, содержащий расширенные параметры преобразования, такие как pageSetup, saveOptions и printSettings.
  • Пример тела запроса:
    {
      "format": "pdf",
      "outPath": "output/converted.pdf",
      "options": {
        "pageSetup": {
          "orientation": "Landscape",
          "paperSize": "A4"
        },
        "saveOptions": {
          "compress": true
        },
        "printSettings": {
          "printHeadings": false
        }
      }
    }
    
  • Ответ:
    • 200 OK – Преобразование успешно завершено; ответ содержит поток преобразованного файла или ссылку на сохранённый файл.
    • 400 Bad Request – Неверные параметры или некорректное тело запроса.
    • 401 Unauthorized – Ошибка аутентификации или отсутствие токена.
    • 500 Internal Server Error – Ошибка сервера во время преобразования.

Коды HTTP-статусов

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

Примечания

  • Некоторые выходные форматы имеют специфические ограничения (например, преобразование в HTML не сохраняет макросы). Подробную информацию см. в документации по конкретным форматам.

Возможность загрузки файлов электронных таблиц из нескольких источников данных

Настройка параметров страницы и параметров сохранения

Семейство облачных SDK

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

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