Добавление изображения в лист Excel — API Aspose.Cells Cloud
Этот REST API добавляет новое изображение в лист Excel.
Необходимые условия: У вас должен быть действительный токен аутентификации Aspose Cloud, существующая рабочая книга, сохранённая в поддерживаемом хранилище, и соответствующие права на изменение листа.
API PutWorksheetAddPicture
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Расположение | Описание |
|---|---|---|---|
| name | string | path | Имя рабочей книги. |
| sheetName | string | path | Имя листа. |
| picture | object | body | Объект изображения (бинарные данные). |
| upperLeftRow | integer | query | Нулевой индекс верхней левой строки, в которую будет помещено изображение. |
| upperLeftColumn | integer | query | Нулевой индекс верхнего левого столбца, в который будет помещено изображение. |
| lowerRightRow | integer | query | Нулевой индекс нижней правой строки области изображения. |
| lowerRightColumn | integer | query | Нулевой индекс нижнего правого столбца области изображения. |
| picturePath | string | query | Путь к файлу изображения; если опущен, данные изображения должны быть переданы в теле запроса. |
| folder | string | query | Папка, содержащая рабочую книгу. |
| storageName | string | query | Имя службы хранилища. |
Примечание к телу запроса: При отсутствии параметра picturePath передавайте бинарные данные изображения в теле запроса, используя multipart/form-data.
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK | Фильтр применён успешно; ответ содержит информацию о выполнении операции. |
| 400 | Bad Request | Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error | Непредвиденная ошибка сервера. |
Пример схемы ответа 200
{
"Code": 200,
"Status": "OK",
"PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}
Примечание: Максимальный размер изображения — 10 МБ; файлы большего размера будут отклонены с ответом 400 Bad Request.
Спецификация OpenAPI определяет общедоступное программное интерфейсное решение и позволяет выполнять взаимодействие с REST непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Следующий пример демонстрирует, как выполнять вызовы в Cloud API с помощью cURL.
Семейство облачных SDK
Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах проекта. Ознакомьтесь с репозиторием на GitHub, чтобы увидеть полный список SDK Aspose.Cells Cloud.
Следующие примеры кода демонстрируют, как выполнять вызовы в веб-сервисы Aspose.Cells с использованием различных SDK:
Примечание: Поддерживаемые форматы изображений включают PNG, JPEG, BMP и GIF. Максимальный размер изображения — 10 МБ; файлы большего размера будут отклонены с ответом 400 Bad Request.