Получить ось категорий диаграммы – документация API Aspose.Cells Cloud

Этот REST API позволяет получить ось категорий диаграммы.
Для вызова этого endpoint необходимо предоставить действительный токен доступа OAuth 2.0, а рабочая книга должна быть сохранена в облачном хранилище Aspose.

Предварительные требования
Перед использованием этого endpoint убедитесь, что:

Получен и действителен токен OAuth 2.0 для сервисов Aspose Cloud.
Файл рабочей книги загружен в облачное хранилище Aspose (в папку по умолчанию или в указанную папку).
Используется версия API v3.0, как указано в URL запроса.
Приложение, выполняющее вызов, имеет разрешение на чтение рабочей книги и доступ к её листам.

API GetChartCategoryAxis

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

Контекст — удаление всех диаграмм с листа полезно, когда необходимо сбросить визуальное оформление листа, заменить устаревшие визуализации или подготовить рабочую книгу к повторному использованию без сохранения предыдущих данных диаграмм.

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

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

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

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

Ответ

{
  "Code": 200,
  "Status": "OK",
  "CategoryAxis": {
    "AxisBetweenCategories": true,
    "AxisLine": {
      "IsVisible": true,
      "Weight": 1.0
    },
    "MajorTickMark": "Cross",
    "MinorTickMark": "None",
    "Title": {
      "Text": "Category Axis",
      "IsVisible": true
    },
    "Labels": {
      "IsAutoRotation": false,
      "RotationAngle": 0,
      "IsVisible": true
    }
  }
}

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

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

Как использовать API GetChartCategoryAxis с SDK

Спецификация API GetChartCategoryAxis

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

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

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/categoryaxis" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Ответ

{
  "Code": 200,
  "Status": "OK",
  "CategoryAxis": {
    "AxisBetweenCategories": true,
    "AxisLine": {
      "IsVisible": true,
      "Weight": 1.0
    },
    "MajorTickMark": "Cross",
    "MinorTickMark": "None",
    "Title": {
      "Text": "Category Axis",
      "IsVisible": true
    },
    "Labels": {
      "IsAutoRotation": false,
      "RotationAngle": 0,
      "IsVisible": true
    }
  }
}

Использование SDK Aspose.Cells Cloud

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

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

Aspose.Cells Cloud API – Обновление оси значений диаграммы (POST /valueaxis) Получить формат заливки области диаграммы – Aspose.Cells Cloud API (v3.0)