Расширенное преобразование файла 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: