Aggiorna Asse Secondario di Categoria del Grafico – Aspose.Cells Cloud API

Questa REST API aggiorna l’asse secondario di categoria di un grafico.

API PostChartSecondCategoryAxis

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

Sicurezza e Autenticazione

Le API REST di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.

Parametri della richiesta

Nome Parametro	Tipo	Posizione	Descrizione
name	string	path	Il nome del file Excel.
sheetName	string	path	Il nome del foglio di lavoro contenente il grafico.
chartIndex	integer	path	L’indice in base zero del grafico da aggiornare.
axis	object	body	L’oggetto dell’asse secondario di categoria con le nuove impostazioni.
folder	string	query	Il percorso della cartella in cui è salvato il file.
storageName	string	query	Il nome del servizio di archiviazione.

Autenticazione – L’API richiede un token di accesso OAuth 2.0 valido. Genera un token JWT seguendo la Guida all’autenticazione. Includi il token nell’intestazione Authorization, come mostrato nell’esempio cURL riportato di seguito.

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL.

Richiesta

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": {
          /* impostazioni asse, ad es. "Title": "Nuovo Titolo Asse", "IsVisible": true */
        }
      }'

Sostituisci {name}, {sheetName}, {chartIndex}, {folder} e {storageName} con i tuoi valori effettivi. Il corpo della richiesta deve contenere l’oggetto axis con le impostazioni desiderate.

Risposta

Risposta corretta (200)

{
  "Code": 200,
  "Status": "OK",
  "Chart": {
    "Id": "chart_1",
    "SecondCategoryAxis": {
      "Title": "Nuovo Titolo Asse",
      "IsVisible": true,
      /* proprietà aggiuntive dell'asse */
    }
  }
}

Risposte di errore

Codice di Stato	Descrizione
400	Richiesta non valida – parametri mancanti o non validi.
401	Non autorizzato – token JWT non valido o mancante.
404	Non trovato – il file, il foglio di lavoro o il grafico specificato non esiste.
500	Errore interno del server – condizione imprevista sul server.

{
  "Code": 400,
  "Message": "Payload della richiesta non valido."
}

Famiglia di SDK Cloud

Gli SDK semplificano lo sviluppo gestendo i dettagli di basso livello e consentendoti di concentrarti sulla logica di business. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Note e Best Practice

Il parametro chartIndex è in base zero; il primo grafico in un foglio di lavoro ha indice 0.
L’API supporta sia il formato di cartella di lavoro .xlsx che .xls.
Includi solo le proprietà necessarie nell’oggetto axis; le proprietà non specificate mantengono i valori esistenti.
Rispetta le linee guida sul limite di velocità (tipicamente 100 richieste al minuto per account) per evitare throttling.

Aspose.Cells Cloud API – Aggiornamento dell’asse dei valori di un grafico (POST /valueaxis)