Aspose.Cells Cloud – Преобразование диапазона Excel в HTML
Преобразуйте выбранный диапазон локальной рабочей книги Excel в HTML-файл непосредственно через Aspose.Cells Cloud. Преобразование происходит полностью на облачном сервере, поэтому вам никогда не нужно загружать всю рабочую книгу или иметь установленный Excel локально.
API преобразования диапазона в HTML
PUT https://api.aspose.cloud/v4.0/cells/convert/range/html
Тело запроса представляет собой multipart/form-data, содержащее файл электронной таблицы. Все остальные параметры передаются как параметры запроса.
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.
Параметры запроса
| Имя | Тип | Местоположение | Обязательный | Описание |
|---|---|---|---|---|
| Spreadsheet | Файл | FormData | Да | Рабочая книга Excel для преобразования. |
| worksheet | Строка | Query | Да | Имя листа, содержащего диапазон. |
| range | Строка | Query | Да | Диапазон ячеек для преобразования, например A1:C10. |
| outPath | Строка | Query | Нет | Путь к папке, где должен быть сохранён результирующий HTML-файл (по умолчанию null). |
| outStorageName | Строка | Query | Нет | Имя облачного хранилища для выходного файла. |
| fontsLocation | Строка | Query | Нет | Путь к пользовательской папке со шрифтами. |
| AutoRowsFit | Булево | Query | Нет | Автоматически подогнать все строки на листе. |
| AutoColumnsFit | Булево | Query | Нет | Автоматически подогнать все столбцы на листе. |
| region | Строка | Query | Нет | Идентификатор языка и региона (например, ru-RU, en-US). Влияет на форматирование чисел и дат. |
| password | Строка | Query | Нет | Пароль для открытия защищённой рабочей книги. |
| fontsLocation | Строка | Query | Нет | Пользовательское расположение шрифтов. |
| region | Строка | Query | Нет | Настройка региона/языка электронной таблицы. |
| password | Строка | Query | Нет | Пароль для открытия файла электронной таблицы. |
Ответ
API возвращает преобразованный HTML-файл в виде двоичного потока (application/octet-stream).
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Пример успешного ответа (HTTP)
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.html"
Content-Length: 8423
<table>
<tr><th>Продукт</th><th>Цена</th></tr>
<tr><td>Widget A</td><td>$10</td></tr>
<tr><td>Widget B</td><td>$15</td></tr>
</table>
Сохраните тело ответа в файл (например, report.html), чтобы просмотреть отображаемую таблицу в браузере.
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр применён успешно; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Неверный или отсутствующий токен JWT. |
| 413 | Payload Too Large (Слишком большой полезный груз) | Загруженный файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API преобразования диапазона в HTML с помощью SDK?
Спецификация OpenAPI
Спецификация OpenAPI описывает публично доступный API, позволяющий выполнять взаимодействие REST напрямую из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells Cloud. В следующем примере показано, как делать вызовы в облачный API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ разработки, так как он абстрагирует низкоуровневые детали и позволяет преобразовать диапазон данных в HTML-файл с минимальным количеством кода.
Полный список SDK Aspose.Cells Cloud вы найдёте в нашем репозитории на GitHub.
Следующие примеры кода иллюстрируют вызов веб-сервисов Aspose.Cells Cloud с использованием различных SDK. Если загрузка из Gist заблокирована, вы можете загрузить примеры напрямую из репозитория.