Платформа интеграции многоканальных данных Excel – Aspose.Cells Cloud API автоматического импорта и преобразования данных.
Основные возможности
Поддержка нескольких форматов данных
- Импорт данных CSV: Поддерживает различные разделители и автоматически определяет кодировку.
- Обработка данных JSON: Преобразует сложные структуры JSON в таблицы Excel.
- Преобразование XML-файлов: Сопоставляет данные узлов со структурой строк и столбцов Excel.
Описание API импорта данных в электронную таблицу
Веб-API
PUT https://api.aspose.cloud/v4.0/cells/import/data
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| datafile | File | FormData | Файл данных (CSV, JSON или XML) для импорта. |
| spreadsheet | File | FormData | Целевая рабочая книга, в которую будут импортированы данные. |
| worksheet | string | Query | Имя рабочего листа, в который будут помещены данные. |
| startCell | string | Query | Ячейка в левом верхнем углу (например, A1), определяющая начальную позицию импорта. |
| insert | bool | Query | true — добавить строки; false — перезаписать существующие данные. |
| convertNumericData | bool | Query | true — преобразовывать строковые числа в числа во время импорта. |
| splitter | string | Query | Разделитель CSV (один символ, по умолчанию ,). |
| outPath | string | Query (опционально) | Путь к папке, где будет сохранена обновлённая рабочая книга. |
| outStorageName | string | Query (опционально) | Имя хранилища для выходного файла. |
| fontsLocation | string | Query (опционально) | Путь к пользовательской папке шрифтов, если требуется. |
| region | string | Query (опционально) | Конфигурация региона электронной таблицы (например, ru-RU). |
| password | string | 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
- Эффективная загрузка данных — позволяет массово импортировать большие объёмы данных непосредственно в рабочую книгу без создания промежуточных файлов.
- Широкая поддержка SDK — предоставляет клиентские библиотеки для .NET, Java, PHP, Ruby, Node.js, Python, Go и Perl, упрощая интеграцию.
- Обработка в памяти — выполняет преобразования в памяти, что снижает требования к временному хранилищу.
Как использовать API импорта данных в электронную таблицу с SDK
Примечания / ограничения: API поддерживает до 1 000 000 строк на один импорт. По умолчанию используется только запятая в качестве разделителя CSV; другие односимвольные разделители можно указать через параметр splitter. Большие XML-файлы могут увеличить время обработки.
Для смежных операций, таких как экспорт данных или преобразование форматов рабочих книг, см. документацию Экспорт данных и Преобразование рабочей книги.
Спецификация API импорта данных в электронную таблицу
Спецификация API импорта данных в электронную таблицу предоставляет публично доступный программный интерфейс, позволяющий взаимодействовать с REST напрямую из веб-браузера. Вы можете использовать утилиту командной строки cURL для лёгкого доступа к веб-сервисам Aspose.Cells. Пример ниже показывает, как выполнять вызовы в облачный API с помощью cURL.