Преобразование Excel в JSON с помощью Aspose.Cells Cloud API — Краткое руководство

REST API

Этот REST API преобразует файл электронной таблицы в файл формата JSON.

POST https://api.aspose.cloud/v3.0/cells/convert/json

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

API облачной платформы Aspose.Cells являются безопасными и требуют аутентификации на основе токена JWT.

Запрос

Параметры запроса (query parameters)

Имя параметра	Тип	Описание
`password`	string	Пароль, необходимый для открытия файла Excel (необязательный).
`storageName`	string	Имя хранилища, в котором расположен файл (необязательный).
`checkExcelRestriction`	bool	Включает ограничения, специфичные для Excel, при изменении ячеек (необязательный).

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

Имя параметра	Тип	Описание
`datafile`	file	Файл Excel, который необходимо загрузить. Должен быть отправлен как первая часть запроса `multipart/form-data`.

Пример вызова с помощью cURL

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Ответ

Сервис возвращает объект FileInfo. Основные поля описаны ниже:

Поле	Тип	Описание
`Filename`	string	Имя созданного JSON-файла (например, `myWorkbook.json`).
`FileSize`	integer	Размер созданного файла в байтах.
`FileContent`	string	Содержимое JSON-файла, закодированное в Base64. Раскодируйте, чтобы получить исходный JSON.

Пример ответа

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (base64 строка) ..."
}

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

В случае ошибки API возвращает объект ошибки со следующей структурой:

Поле	Тип	Описание
`Code`	string	Машинно-читаемый идентификатор ошибки.
`Message`	string	Человеко-читаемое описание ошибки.

Типичные HTTP-коды статуса:

400 – Неверный запрос (например, отсутствует файл, неверные параметры).
401 – Неавторизованный доступ (недействительный или отсутствующий токен доступа).
500 – Внутренняя ошибка сервера.

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

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

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

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

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

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

Запрос

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Ответ

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH... (base64 строка)"
}

Использование SDK облачной платформы Aspose.Cells

Использование SDK — это лучший способ ускорить разработку. SDK берёт на себя обработку низкоуровневых деталей, позволяя сосредоточиться на задачах вашего проекта. Ознакомьтесь с полным списком SDK облачной платформы Aspose.Cells в репозитории на GitHub.

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

Другие API, реализующие аналогичный функционал

POST /cells/{name}/saveAs – Сохраняет файл Excel как файл HTML с дополнительными настройками и сохраняет результат в указанном хранилище.
PUT /cells/convert – Преобразует файл Excel в файл HTML с дополнительными настройками и возвращает результат в ответе.
GET /cells/{name} – Получает файл Excel; может использоваться с параметрами запроса для получения файла в формате HTML.

Конвертирование Excel в HTML