Преобразование Excel в PDF — Aspose.Cells Cloud API
Этот REST API преобразует файл электронной таблицы в файл формата PDF. Необходимые условия: получите действительный JWT-токен доступа, убедитесь, что исходный файл Excel хранится в поддерживаемом хранилище, и обладайте соответствующими правами для вызова конечной точки преобразования.
API PostConvertWorkbookToPDF
POST https://api.aspose.cloud/v3.0/cells/convert/pdf
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификации на основе токена JWT.
Параметр запроса (query parameter)
| Имя параметра | Тип | Описание |
|---|---|---|
| password | string | Пароль для открытия файла Excel. |
| storageName | string | Имя хранилища, в котором находится файл. |
| checkExcelRestriction | bool | Следует ли применять ограничения файлов Excel при изменении объектов, связанных с ячейками. |
Если параметр checkExcelRestriction опущен, по умолчанию он принимает значение false.
Параметр тела запроса
| Имя параметра | Тип | Описание |
|---|---|---|
| datafile | file | Файл данных, сохраняемый в качестве первой части мультитекстового содержимого. |
Ответ
В ответе возвращается объект JSON с метаданными файла. Сам файл PDF можно загрузить, используя предоставленное поле FileContent (base64) или по ссылке из FileInfo. API возвращает объект JSON типа FileInfo:
- FileInfo — объект, содержащий имя, размер и содержимое сгенерированного файла PDF в кодировке base64.
{
"Filename": "example.pdf",
"FileSize": 12345,
"FileContent": "base64_encoded_string"
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error | Непредвиденная ошибка сервера. |
Как использовать API PostConvertWorkbookToPDF с SDK
Спецификация API PostConvertWorkbookToPDF
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Заголовки запроса
| Заголовок | Тип | Описание |
|---|---|---|
| Authorization | string | Bearer-токен, полученный при аутентификации через JWT. |
| Content-Type | string | Должен быть multipart/form-data для загрузки файла. |
| Accept | string | application/json для получения метаданных ответа. |
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Включите токен доступа в заголовок Authorization, затем выполните запрос ниже.
Использование SDK Aspose.Cells Cloud
Использование SDK упрощает разработку, скрывая низкоуровневые детали. Полный список SDK Aspose.Cells Cloud представлен в репозитории на GitHub.
Примеры кода ниже демонстрируют вызовы веб-сервисов Aspose.Cells с использованием различных SDK:
Другие API, реализующие эту функцию
| API | Тип | Описание | Ссылка Swagger |
|---|---|---|---|
| /cells/convert | PUT | Преобразует рабочую книгу из содержимого запроса в указанный формат. | PutConvertWorkBook |
API POST /cells/{name}/saveAs позволяет сохранить файл MS Excel в формате PDF с дополнительными настройками и сохранить результат в хранилище.
Этот REST API преобразует файл Excel в PDF.
API PUT /cells/convert позволяет преобразовать файл MS Excel в PDF с дополнительными настройками и вернуть результат в ответе.
API GET /cells/{name} позволяет преобразовать файл MS Excel в PDF с дополнительными настройками и вернуть результат в ответе.
Эти API — PutConvertWorkBook, GetWorkBook и PostDocumentSaveAs — определяют публично доступный программный интерфейс и позволяют выполнять REST-взаимодействия непосредственно из веб-браузера.
Дополнительные варианты преобразования доступны на странице Параметры сохранения.