Импорт целочисленного массива в рабочую тетрадь Excel – API Aspose.Cells Cloud
Этот REST API импортирует целочисленный массив в рабочую тетрадь Excel.
Запрос должен быть HTTP POST с многочастным содержимым (см. RFC 2046 или RFC 1341). Первая часть многочастного тела содержит JSON-полезную нагрузку ImportIntegerArrayOption, а вторая часть — исходный файл данных (например, CSV-файл или двоичный файл Excel).
API PostImportData
POST https://api.aspose.cloud/v3.0/cells/import
Оба конечных пункта принимают одну и ту же многочастную полезную нагрузку. Первый конечный пункт выполняет общую операцию импорта, а второй нацелен на конкретную рабочую книгу, идентифицируемую по {name}.
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе маркера JWT.
Параметры запроса
ImportIntegerArrayOption
| Имя параметра | Тип | Описание |
|---|---|---|
| FirstRow | int | Индекс первой строки (начиная с нуля), в которую будут помещены данные. |
| FirstColumn | int | Индекс первого столбца (начиная с нуля), в который будут помещены данные. |
| IsVertical | boolean | true, чтобы вставить массив вертикально (вниз по столбцу); false, чтобы вставить его горизонтально (вдоль строки). |
| Data | Integer[] | Целочисленный массив для импорта. |
| DestinationWorksheet | string | Имя рабочего листа, который получит данные. |
| IsInsert | boolean | true, чтобы вставить строки/столбцы перед записью данных; false, чтобы перезаписать существующие ячейки. |
| ImportDataType | string | Тип импортируемых данных. Допустимые значения: IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData. |
| Source | FileSource | Указывает расположение файла данных, когда параметр BatchData имеет значение null. |
Пример тела запроса
{
"Data": [1, 2, 4],
"DestinationWorksheet": "Sheet1",
"FirstRow": 1,
"FirstColumn": 2,
"IsVertical": true,
"IsInsert": true,
"ImportDataType": "IntArray"
}
Ответ
Успешный запрос возвращает HTTP 200 с JSON-полезной нагрузкой, подобной следующей:
{
"Code": 200,
"Status": "OK"
}
Возможные коды состояния:
| Код | Значение |
|---|---|
| 200 | Импорт успешно завершён |
| 400 | Неверный запрос — отсутствующие или недопустимые данные |
| 401 | Неавторизован — недопустимый или отсутствующий токен |
| 500 | Внутренняя ошибка сервера |
Как использовать API PostImportData с SDK
Спецификация API PostImportData
Спецификация OpenAPI определяет публично доступный программный интерфейс и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ интеграции этого функционала. SDK абстрагируют низкоуровневые детали, позволяя сосредоточиться на бизнес-логике. Полный список SDK Aspose.Cells Cloud см. в репозитории на GitHub.
Следующие примеры кода демонстрируют вызов веб-служб Aspose.Cells с использованием различных SDK: