Обновление свойств диаграммы – Aspose.Cells Cloud REST API
Этот REST API обновляет свойства диаграммы.
Безопасность и аутентификация
Aspose.Cells Cloud API защищены и требуют аутентификацию по токену JWT.
API PostWorksheetChart
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}
Параметры запроса
| Имя параметра | Тип | Путь/Строка запроса/HTTP-тело | Описание |
|---|---|---|---|
| name | string | path | Имя файла Excel. |
| sheetName | string | path | Имя листа, содержащего диаграмму. |
| chartIndex | integer | path | Индекс диаграммы (отсчитывается от нуля), подлежащей обновлению. |
| chart | object | body | JSON-объект, определяющий обновляемые свойства диаграммы. |
| folder | string | query | Папка в хранилище, где расположен файл. |
| storageName | string | query | Имя сервиса хранилища. |
Схема тела запроса
Объект chart содержит свойства, которые можно изменить. Ниже приведён типичный пример JSON, включающий несколько часто используемых полей:
{
"Title": {
"Text": "Квартальные продажи"
},
"ShowLegend": true,
"Type": "Line",
"DataLabels": {
"ShowValue": true,
"ShowPercentage": false
},
"ChartArea": {
"BorderColor": "Blue",
"FillColor": "White"
}
}
Примечание: Необходимо передавать только те поля, которые требуется изменить. Неуказанные свойства сохранят свои текущие значения.
Спецификация OpenAPI определяет публично доступное программное интерфейсное API и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Для простого доступа к веб-сервисам Aspose.Cells вы можете использовать утилиту командной строки cURL. В следующем примере показано, как выполнять вызовы в Cloud API с помощью cURL.
Ответ
API возвращает JSON-объект, указывающий результат операции. При успешном обновлении возвращается:
{
"Code": 200,
"Status": "OK"
}
Коды успешного состояния
| HTTP-статус | Описание |
|---|---|
| 200 | OK — свойства диаграммы успешно обновлены. |
Заголовки ответа
| Заголовок | Описание |
|---|---|
Content-Type |
application/json — указывает, что тело ответа имеет формат JSON. |
X-RequestId |
Уникальный идентификатор запроса (полезно для устранения неполадок). |
Возможные ответы об ошибках:
| HTTP-статус | Описание |
|---|---|
| 400 | Bad Request — неверные параметры или тело запроса |
| 401 | Unauthorized — отсутствует или неверен токен |
| 404 | Not Found — файл, лист или диаграмма не найдены |
| 500 | Internal Server Error — внутренняя ошибка сервера |
Для других операций, связанных с диаграммами, см. смежные разделы, например Обновление заголовка диаграммы и Обновление легенды диаграммы.
Семейство облачных SDK
Использование SDK — это лучший способ ускорить разработку. SDK берёт на себя низкоуровневые детали и позволяет сосредоточиться на задачах проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Приведённые ниже примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: