Обновление второй категориальной оси диаграммы – Aspose.Cells Cloud API

Этот REST API обновляет вторую категориальную ось диаграммы.

API PostChartSecondCategoryAxis

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/secondcategoryaxis

Безопасность и аутентификация

Облачные API Aspose.Cells защищены и требуют аутентификации на основе маркера JWT.

Параметры запроса

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла Excel.
sheetName	string	path	Имя рабочего листа, содержащего диаграмму.
chartIndex	integer	path	Индекс диаграммы (начиная с 0), подлежащий обновлению.
axis	object	body	Объект второй категориальной оси с новыми настройками.
folder	string	query	Путь к папке, где хранится файл.
storageName	string	query	Имя службы хранилища.

Аутентификация – API требует действительного токена доступа OAuth 2.0. Получите JWT-токен, следуя руководству по аутентификации. Включите токен в заголовок Authorization, как показано в примере cURL ниже.

Спецификация OpenAPI определяет общедоступное программное интерфейсное решение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как выполнять вызовы облачного API с помощью cURL.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/secondcategoryaxis?folder={folder}&storageName={storageName}" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{ 
        "axis": {
          /* настройки оси, например, "Title": "Новый заголовок оси", "IsVisible": true */
        }
      }'

Замените {name}, {sheetName}, {chartIndex}, {folder} и {storageName} на ваши фактические значения. Тело запроса должно содержать объект axis с нужными настройками.

Ответ

Успешный ответ (200)

{
  "Code": 200,
  "Status": "OK",
  "Chart": {
    "Id": "chart_1",
    "SecondCategoryAxis": {
      "Title": "Новый заголовок оси",
      "IsVisible": true,
      /* дополнительные свойства оси */
    }
  }
}

Ответы с ошибками

Код состояния	Описание
400	Неверный запрос – отсутствуют или недопустимы параметры.
401	Неавторизован – недействительный или отсутствующий JWT-токен.
404	Не найдено – указанный файл, рабочий лист или диаграмма не существует.
500	Внутренняя ошибка сервера – непредвиденное состояние на сервере.

{
  "Code": 400,
  "Message": "Неверная полезная нагрузка запроса."
}

Семейство облачных SDK

SDK упрощают разработку, скрывая низкоуровневые детали и позволяя сосредоточиться на бизнес-логике. Ознакомьтесь со списком SDK Aspose.Cells Cloud на GitHub.

Следующие примеры кода демонстрируют, как выполнять вызовы веб-сервисов Aspose.Cells с использованием различных SDK:

Примечания и рекомендации

Параметр chartIndex индексируется с нуля: первая диаграмма на рабочем листе имеет индекс 0.
API поддерживает форматы рабочих книг .xlsx и .xls.
В объект axis включайте только необходимые свойства; неуказанные свойства сохраняют свои текущие значения.
Соблюдайте ограничения по частоте запросов (обычно 100 запросов в минуту на аккаунт), чтобы избежать ограничения скорости.

Aspose.Cells Cloud API – Обновление оси значений диаграммы (POST /valueaxis)