Добавление фигуры в рабочий лист Excel с использованием Aspose.Cells Cloud API
Этот REST API добавляет фигуру в рабочий лист Excel.
Конечная точка относится к версии API v3.0; убедитесь, что вы используете JWT-токен доступа, получённый через OAuth2-поток Aspose Cloud (client‑id/client‑secret), и включаете его в заголовок Authorization: Bearer <token>.
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификации по токену JWT.
PutWorksheetShape API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя документа. |
| sheetName | string | path | Имя рабочего листа. |
| shapeDTO | object | body | JSON-объект, описывающий добавляемую фигуру (полная схема указана в спецификации OpenAPI). |
| drawingType | string | query | Тип объекта фигуры (например, arc, line, rectangle). |
| upperLeftRow | integer | query | Индекс верхней левой строки фигуры. |
| upperLeftColumn | integer | query | Индекс верхнего левого столбца фигуры. |
| top | integer | query | Вертикальное смещение фигуры от её верхнего края в пикселях. |
| left | integer | query | Горизонтальное смещение фигуры от её левого края в пикселях. |
| width | integer | query | Ширина фигуры в пикселях. |
| height | integer | query | Высота фигуры в пикселях. |
| folder | string | query | Папка, содержащая документ. |
| storageName | string | query | Имя хранилища. |
Спецификация OpenAPI определяет публично доступное программное интерфейсное решение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для лёгкого доступа к веб-сервисам Aspose.Cells. Следующий пример демонстрирует вызов облачного API с помощью cURL.
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized | Недопустимый или отсутствующий JWT-токен. |
| 413 | Payload Too Large | Загружаемый файл превышает допустимый размер. |
| 500 | Internal Server Error | Непредвиденная ошибка сервера. |
Типичные ответы об ошибках включают:
- 400 Bad Request — отсутствуют или недопустимы параметры.
- 401 Unauthorized — недопустимый или отсутствующий JWT-токен.
- 404 Not Found — указанный рабочий лист или документ не существует.
Каждая ошибка возвращается в виде JSON-объекта, содержащего поля Code и Message.
Семейство облачных SDK
Использование SDK — лучший способ ускорить разработку. SDK берёт на себя обработку низкоуровневых деталей, позволяя сосредоточиться на задачах проекта. Полный список облачных SDK Aspose.Cells доступен в репозитории GitHub.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: