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

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

API PostChartCategoryAxis

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

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

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

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

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

Схема тела запроса — объект axis

Свойство	Тип	Описание
IsAutomaticMajorUnit	boolean	Определяет, вычисляется ли основной интервал автоматически.
MajorUnit	number	Значение основного интервала, если `IsAutomaticMajorUnit` равно `false`.
IsAutomaticMinorUnit	boolean	Определяет, вычисляется ли вспомогательный интервал автоматически.
MinorUnit	number	Значение вспомогательного интервала, если `IsAutomaticMinorUnit` равно `false`.
Title	object	Настройки заголовка оси (например, `Text`, `Font`, `Visible`).
TickLabelPosition	string	Позиция меток делений (например, `Low`, `High`, `NextToAxis`).
…	…	Дополнительные свойства оси, определённые в спецификации API.

Коды HTTP-статуса

Код	Значение	Описание
200	OK (ОК)	Фильтр применён успешно; ответ содержит детали операции.
400	Bad Request (Неверный запрос)	Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401	Unauthorized (Неавторизован)	Недействительный или отсутствующий токен JWT.
413	Payload Too Large (Слишком большой полезный груз)	Загруженный файл превышает ограничение по размеру.
500	Internal Server Error (Внутренняя ошибка сервера)	Непредвиденная ошибка сервера.

Предварительные требования / Аутентификация

Для вызова этого конечного пункта необходимо получить токен доступа JWT из службы аутентификации Aspose.Cells Cloud (/connect/token). Включите токен в заголовок Authorization, как показано в примере ниже.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/categoryaxis?folder={folder}&storageName={storageName}" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "axis": {
          "IsAutomaticMajorUnit": true,
          "IsAutomaticMinorUnit": true,
          "Title": {
            "Text": "Category Axis",
            "Visible": true
          }
        }
      }'

Response

Пример ответа

{
  "Code": 200,
  "Status": "OK"
}

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

Примечания

Конечная точка требует использования HTTPS; использование HTTP может вызвать предупреждения о смешанном контенте в браузерах.
Все подставляемые значения ({name}, {sheetName}, {chartIndex}, {folder}, {storageName}) должны быть заменены реальными идентификаторами.
Поддерживаемые типы диаграмм для обновления оси категорий указаны в справочнике по API.

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

Использование SDK — это лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали и позволяет сосредоточиться на задачах проекта. Ознакомьтесь со репозиторием на GitHub, чтобы получить полный список облачных SDK Aspose.Cells.

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

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