Получение фигуры по индексу на листе Excel – Документация Aspose.Cells Cloud
Этот REST API извлекает фигуру (включая её растровые данные или метаданные) с листа Excel.
API GetWorksheetShape
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}
Необходимые условия
- Действующий маркер доступа Aspose Cloud (Bearer JWT).
- Рабочая книга должна находиться в вашем облачном хранилище Aspose Cloud или в указанной папке.
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе маркера JWT.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя документа Excel. |
| sheetName | string | path | Имя листа, содержащего фигуру. |
| shapeindex | integer | path | Индекс фигуры на листе (начинается с 0). |
| folder | string | query | Путь к папке, где сохранён документ. |
| storageName | string | query | Имя сервиса хранилища. |
Примечание: shapeindex — индексация начинается с 0; первая фигура имеет индекс 0. Убедитесь, что рабочая книга сохранена в указанной folder и storageName, если вы не используете хранилище по умолчанию.
Спецификация OpenAPI определяет общедоступное программное интерфейсное описание и позволяет выполнять взаимодействие по REST напрямую из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже показывает, как выполнить вызов облачного API с помощью cURL.
Возможные коды HTTP-статуса
| Код | Описание |
|---|---|
| 200 OK | Фигура успешно получена. |
| 400 Bad Request | Запрос имеет некорректный формат или отсутствуют обязательные параметры. |
| 401 Unauthorized | Аутентификация не удалась или маркер отсутствует/недействителен. |
| 404 Not Found | Указанная рабочая книга, лист или индекс фигуры не найдены. |
| 500 Internal Server Error | Произошла непредвиденная ошибка сервера. |
Типичные ошибки: Использование некорректного домена верхнего уровня (api.aspose.com) или устаревшего сегмента /autoshapes/ приведёт к ошибке 404. Всегда используйте сегмент /shapes/ с доменом api.aspose.cloud.
Семейство облачных SDK
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:
См. также документацию по смежным операциям: Добавление фигуры и Обновление фигуры.