Ottieni il commento del foglio di calcolo – Documentazione API di Aspose.Cells Cloud
Questa REST API consente di recuperare un commento di un foglio di calcolo per nome di cella utilizzando Aspose.Cells Cloud.
Prerequisiti: Per chiamare questa operazione, è necessario includere un token di accesso JWT valido nell’header Authorization (Bearer <jwt token>). I token possono essere ottenuti tramite il flusso di autenticazione di Aspose.Cells Cloud descritto nella guida all’autenticazione.
API GetWorksheetComment
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/comments/{cellName}
Sicurezza e autenticazione
Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
Parametri della richiesta
| Nome parametro | Tipo | Posizione (percorso URL / stringa di query) | Descrizione |
|---|---|---|---|
| name | string | Percorso URL | Nome del file Excel. |
| sheetName | string | Percorso URL | Nome del foglio di calcolo contenente il commento. |
| cellName | string | Percorso URL | Indirizzo della cella (ad esempio A1) di cui recuperare il commento. |
| folder | string | Stringa di query | Percorso della cartella in cui è memorizzato il documento. |
| storageName | string | Stringa di query | Nome del servizio di archiviazione. |
La specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.
È possibile utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud con cURL.
Risposta: L’API restituisce un oggetto JSON contenente un oggetto Comment con i seguenti campi:
| Campo | Tipo | Descrizione |
|---|---|---|
CellName |
string | Indirizzo della cella (ad esempio A1). |
Author |
string | Nome dell’autore del commento. |
HtmlNote |
string | Contenuto del commento in formato HTML (se presente). |
Note |
string | Versione in testo normale del commento. |
AutoSize |
boolean | Indica se il riquadro del commento si ridimensiona automaticamente. |
IsVisible |
boolean | Determina se il commento è visibile. |
Width |
integer | Larghezza del riquadro del commento (in caratteri). |
Height |
integer | Altezza del riquadro del commento (in caratteri). |
TextHorizontalAlignment |
string | Allineamento orizzontale del testo (ad esempio Bottom). |
TextOrientationType |
string | Orientamento del testo (ad esempio TopToBottom). |
TextVerticalAlignment |
string | Allineamento verticale del testo (ad esempio Bottom). |
Errori comuni
- 401 Unauthorized – Verificare che il token JWT sia valido, non scaduto e correttamente inserito nell’header
Authorization. - 404 Not Found – Assicurarsi che il nome del file, il nome del foglio e l’indirizzo della cella siano corretti e che il file esista nella cartella/archiviazione specificata.
- 500 Internal Server Error – Verificare la presenza di dati malformed nel payload della richiesta e confermare che il servizio sia operativo.
Codici di stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta non valida (Bad Request) | Parametri mancanti o non validi (ad esempio tipo di file non supportato). |
| 401 | Non autorizzato (Unauthorized) | Token JWT non valido o mancante. |
| 413 | Payload troppo grande (Payload Too Large) | Il file caricato supera il limite di dimensione. |
| 500 | Errore interno del server (Internal Server Error) | Errore imprevisto del server. |
Famiglia di SDK Cloud
L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. 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: