Как преобразовать табличные данные локальной электронной таблицы в файл JSON: пошаговое руководство

Преобразуйте локальную таблицу электронной таблицы/Excel в файл JSON с помощью Aspose.Cells Cloud Web API.

API преобразования таблицы в JSON

Web API

PUT https://api.aspose.cloud/v4.0/cells/convert/table/json

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

Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.

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

Имя параметра	Тип	Расположение	Описание
Spreadsheet	Файл	FormData	Загружаемый файл Excel.
worksheet	Строка	Query	Имя рабочего листа, содержащего таблицу.
tableName	Строка	Query	Имя преобразуемой таблицы.
outPath	Строка	Query	(Необязательно) Путь к папке, где будет сохранён результирующий файл JSON; по умолчанию null.
outStorageName	Строка	Query	(Необязательно) Имя хранилища, в котором будет размещён выходной файл.
fontsLocation	Строка	Query	(Необязательно) Путь к пользовательским шрифтам, используемым во время преобразования.
region	Строка	Query	(Необязательно) Региональные настройки для рабочей книги.
password	Строка	Query	(Необязательно) Пароль для открытия защищённой рабочей книги.

Ответ

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

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

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

Где следует использовать API преобразования таблицы в JSON?

Интерактивные панели мониторинга в реальном времени – Преобразуйте живые данные Excel в JSON для использования с библиотеками визуализации, такими как Chart.js или D3.js.
Таблицы как сервис (Spreadsheet-as-a-Service) – Предоставьте таблицы Excel в виде JSON-эндпоинтов для других микросервисов.
Полезные нагрузки веб-перехватчиков (Webhook Payloads) – Преобразуйте данные таблиц в JSON для уведомлений через веб-перехватчики.
Быстрое прототипирование данных – Быстро преобразуйте очищенные данные Excel в JSON для анализа в Python или R.
Конвейеры машинного обучения – Предварительно обрабатывайте обучающие данные, хранящиеся в бизнес-таблицах.
Операции в электронной коммерции – Синхронизируйте каталоги товаров или прайс-листы с веб-сайтами через JSON.
Автоматизация отчётов – Генерируйте JSON-ленты из финансовых моделей для автоматизированной генерации отчётов.
Конфигурация приложений – Управляйте флагами функций, настройками или параметрами A/B-тестов в Excel → JSON.
Многоязычная поддержка – Преобразуйте локализационные таблицы в JSON для библиотек интернационализации (i18n).
Динамические меню/навигация – Храните структуры навигации веб-сайта в Excel и развертывайте их как JSON.

Почему следует использовать API преобразования таблицы в JSON?

Удобен для разработчиков – Aspose.Cells Cloud предоставляет SDK для множества языков, что снижает усилия по разработке и обеспечивает исчерпывающую документацию.
Экономически эффективно – Преобразуйте табличные данные без предварительной загрузки рабочей книги, экономя место в хранилище и снижая затраты.
Совместимость с современными веб- и мобильными платформами – JSON — нативный язык данных для веба; API позволяет напрямую подавать живые данные электронной таблицы в React, Vue, Angular, мобильные приложения или одностраничные приложения без сложного парсинга.
Широкая поддержка языков – JSON работает практически со всеми языками программирования, базами данных и веб-сервисами.
Сохранение структурированных данных
- Интеллектуальное определение структуры – Автоматически преобразует табличные данные в корректные массивы/объекты JSON.
- Сопоставление заголовков – Использует первую строку в качестве ключей JSON для создания чистых структур объектов.
- Сохранение типов данных – Сохраняет числа, даты и логические значения (не только текст).

История версий: Эндпоинт преобразования таблицы в JSON был добавлен в API версии v4.0 (2024 г.) и остаётся текущей стабильной версией. Предыдущие эндпоинты версии v3.x устарели.

Как использовать API преобразования таблицы в JSON с SDK?

Спецификация API преобразования таблицы в JSON

Спецификация API преобразования таблицы в JSON{:target="_blank" rel=“noopener noreferrer”} предоставляет общедоступное программное интерфейсное описание, позволяющее выполнять REST-взаимодействия непосредственно из веб-браузера.

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

Запрос

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/json?worksheet=Sheet1&tableName=Table1" \
  -H "Authorization: Bearer {access_token}" \
  -F "Spreadsheet=@myWorkbook.xlsx" \
  -o converted.json

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/table/json?worksheet=Sheet1&tableName=MyTable" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@/path/to/your/file.xlsx" \
     -F "outPath=output/folder" \
     -F "outStorageName=MyStorage"

Ответ

{
  "type": "FileContentResult",
  "fileContents": "byte[] (Base64 encoded)",
  "contentType": "MIME type",
  "fileDownloadName": "optional file name"
}

{
 "Code": 200,
 "Status": "OK"
}

Использование SDK Aspose.Cells Cloud

Использование SDK абстрагирует низкоуровневые детали, позволяя преобразовать табличные данные электронной таблицы в файл JSON с минимальным объёмом кода. Полный список SDK Aspose.Cells Cloud доступен в официальном репозитории на GitHub.

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

Преобразование диапазона Excel в CSV — Aspose.Cells Cloud API Преобразование таблицы в PDF