Get Chart Category Axis – Aspose.Cells Cloud API Documentation

This REST API retrieves the Category Axis of a chart.
To call this endpoint you must provide a valid OAuth 2.0 access token, and the workbook must be stored in Aspose Cloud storage.

Prerequisites
Before using this endpoint, ensure that:

  • An OAuth 2.0 token has been obtained and is valid for the Aspose Cloud services.
  • The workbook file is uploaded to Aspose Cloud storage (default or a specified folder).
  • You are using API version v3.0 as shown in the request URL.
  • The calling application has permission to read the workbook and access its worksheets.

GetChartCategoryAxis API

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

Background – Removing all charts from a worksheet is useful when you need to reset a sheet’s visual layout, replace outdated visualizations, or prepare a workbook for reuse without retaining previous chart data.

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

Request parameters

Parameter Name Type Location Description
name string path The name of the workbook file.
sheetName string path The name of the worksheet containing the chart.
chartIndex integer path Zero‑based index of the chart whose axis is requested.
folder string query The folder path in storage where the workbook resides.
storageName string query The name of the storage service (if not the default).

Response

{
  "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 Status Codes

Code Meaning Description
200 OK Filter applied successfully; response contains operation details.
400 Bad Request Missing or invalid parameters (e.g., unsupported file type).
401 Unauthorized Invalid or missing JWT token.
413 Payload Too Large Uploaded file exceeds size limit.
500 Internal Server Error Unexpected server error.

How to Use the GetChartCategoryAxis API with SDKs

GetChartCategoryAxis API Specification

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to make a call to the Cloud API with cURL.

Use Aspose.Cells Cloud SDKs

Using an SDK is the best way to speed up development. An SDK handles low‑level details and lets you focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to call Aspose.Cells web services using various SDKs:

Aspose.Cells Cloud API – Update Chart Value Axis (POST /valueaxis) Get Chart Area Fill Format – Aspose.Cells Cloud API (v3.0)