Zweite Kategorienachse eines Diagramms aktualisieren – Aspose.Cells Cloud API

Diese REST API aktualisiert die zweite Kategorienachse eines Diagramms.

PostChartSecondCategoryAxis API

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

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Der Name der Excel-Datei.
sheetName	string	path	Der Name des Arbeitsblatts, das das Diagramm enthält.
chartIndex	integer	path	Der nullbasierte Index des zu aktualisierenden Diagramms.
axis	object	body	Das Objekt der zweiten Kategorienachse mit den neuen Einstellungen.
folder	string	query	Der Ordnerpfad, in dem die Datei gespeichert ist.
storageName	string	query	Der Name des Speicherdienstes.

Authentifizierung – Die API erfordert ein gültiges OAuth 2.0-Access-Token. Erzeugen Sie ein JWT-Token gemäß der Authentifizierungsanleitung. Geben Sie das Token im Authorization-Header an, wie im folgenden cURL-Beispiel gezeigt.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das cURL-Befehlszeilentool nutzen, um Aspose.Cells-Webdienste einfach anzusprechen. Das folgende Beispiel zeigt, wie Sie mithilfe von cURL Aufrufe an die Cloud API durchführen.

Anforderung

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": {
          /* Achseneinstellungen, z. B. "Title": "Neuer Achsentitel", "IsVisible": true */
        }
      }'

Ersetzen Sie {name}, {sheetName}, {chartIndex}, {folder} und {storageName} durch Ihre tatsächlichen Werte. Der Anforderungstext muss das axis-Objekt mit den gewünschten Einstellungen enthalten.

Antwort

Erfolgreiche Antwort (200)

{
  "Code": 200,
  "Status": "OK",
  "Chart": {
    "Id": "chart_1",
    "SecondCategoryAxis": {
      "Title": "Neuer Achsentitel",
      "IsVisible": true,
      /* zusätzliche Achseneigenschaften */
    }
  }
}

Fehlerantworten

Statuscode	Beschreibung
400	Ungültige Anforderung – fehlende oder ungültige Parameter.
401	Nicht autorisiert – ungültiges oder fehlendes JWT-Token.
404	Nicht gefunden – die angegebene Datei, das Arbeitsblatt oder Diagramm existiert nicht.
500	Interner Serverfehler – unerwarteter Zustand auf dem Server.

{
  "Code": 400,
  "Message": "Ungültige Anforderungsnutzlast."
}

Cloud SDK-Familie

SDKs vereinfachen die Entwicklung, indem sie Details auf niedriger Ebene abstrahieren und Ihnen ermöglichen, sich auf Ihre Geschäftslogik zu konzentrieren. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs einzusehen.

Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webdienste mithilfe verschiedener SDKs durchgeführt werden:

Hinweise und Best Practices

Der chartIndex-Parameter ist nullbasiert; das erste Diagramm in einem Arbeitsblatt hat den Index 0.
Die API unterstützt sowohl die Arbeitsmappenformate .xlsx als auch .xls.
Geben Sie im axis-Objekt nur die gewünschten Eigenschaften an; nicht angegebene Eigenschaften behalten ihre aktuellen Werte bei.
Halten Sie sich an die Richtlinien zur Anfragelimitierung (typischerweise 100 Anfragen pro Minute pro Konto), um Throttling zu vermeiden.

Aspose.Cells Cloud API – Wertachse eines Diagramms aktualisieren (POST /valueaxis)