Получение данных ячеек по именованному диапазону — Aspose.Cells Cloud API
Необходимые условия
- Действующий JWT-токен доступа с соответствующей областью действия.
- Книга должна быть загружена в облачное хранилище Aspose (или в указанную папку).
- При использовании нестандартного хранилища необходимо указать его имя.
Этот REST API возвращает список ячеек в диапазоне, определяемом по именованному диапазону или по индексам строки и столбца.
Эта операция позволяет разработчикам программно получать значения ячеек, принадлежащих конкретному именованному диапазону в рабочем листе Excel. При передаче идентификатора namedRange либо явных индексов строки и столбца API возвращает подробный список ячеек, включая их адрес, строку, столбец, значение, тип данных и информацию о форматировании. Ответ может использоваться для создания приложений, основанных на данных, генерации отчётов или выполнении дополнительных вычислений на стороне сервера. Сервис Aspose.Cells Cloud поддерживает множество языков программирования через SDK, обеспечивая беспрепятственную интеграцию независимо от платформы разработки. Использование HTTPS гарантирует защищённую передачу данных, а API соответствует принципам REST, возвращая стандартные коды состояния HTTP для успешных и ошибочных операций.
REST API
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя файла книги. |
| sheetName | string | path | Имя рабочего листа внутри книги. |
| namedRange | string | query | Имя именованного диапазона для извлечения, например A1:B2 или range_name1. |
| firstRow | integer | query | Нулевой индекс первой строки диапазона (используется, если namedRange не задан). |
| firstColumn | integer | query | Нулевой индекс первого столбца диапазона (используется, если namedRange не задан). |
| rowCount | integer | query | Количество строк в диапазоне. |
| columnCount | integer | query | Количество столбцов в диапазоне. |
| folder | string | query | Папка, содержащая книгу. |
| storageName | string | query | Имя облачного хранилища, в котором находится книга. |
OpenAPI-спецификация определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для вызова веб-сервисов Aspose.Cells. Ниже приведён пример запроса значений ячеек из именованного диапазона.
Примечание по безопасности: Всегда используйте HTTPS при вызове API. Сервис не поддерживает незащищённый HTTP; использование HTTPS гарантирует шифрование запроса и соответствие лучшим практикам безопасности.
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; в ответе содержатся детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой payload) | Загруженный файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Пример ответа об ошибке (400 Bad Request)
{
"Code": 400,
"Status": "Bad Request",
"Message": "Отсутствует или недопустим параметр 'namedRange'."
}
Совет: API использует нулевые индексы для
firstRowиfirstColumn. Например, первая строка рабочего листа имеет индекс0.
Семейство облачных SDK
Использование SDK — наиболее эффективный способ ускорения разработки. SDK абстрагирует низкоуровневые детали, позволяя сосредоточиться на бизнес-логике. Полный список SDK Aspose.Cells Cloud доступен на GitHub-репозитории.
Приведённые ниже примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: