Ottenere una forma per indice in un foglio di lavoro Excel – Documentazione di Aspose.Cells Cloud
Questa API REST recupera una forma (inclusi i dati dell’immagine o i metadati) da un foglio di lavoro Excel.
API GetWorksheetShape
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}
Prerequisiti
- Un token di accesso valido per Aspose Cloud (Bearer JWT).
- Il foglio di lavoro deve essere memorizzato nello storage di Aspose Cloud o in una cartella specificata.
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 | Descrizione |
|---|---|---|---|
| name | string | path | Nome del documento Excel. |
| sheetName | string | path | Nome del foglio di lavoro contenente la forma. |
| shapeindex | integer | path | Indice in base zero della forma all’interno del foglio di lavoro. |
| folder | string | query | Percorso della cartella in cui è memorizzato il documento. |
| storageName | string | query | Nome del servizio di archiviazione. |
Nota: shapeindex è in base zero; la prima forma ha indice 0. Assicurarsi che il foglio di lavoro sia memorizzato nella cartella e nello storageName specificati se non si utilizza lo storage predefinito.
La specifica OpenAPI definisce 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.
Codici di stato HTTP possibili
| Codice | Descrizione |
|---|---|
| 200 OK | La forma è stata recuperata correttamente. |
| 400 Bad Request | La richiesta è malformata o mancano parametri obbligatori. |
| 401 Unauthorized | Autenticazione non riuscita o token mancante/non valido. |
| 404 Not Found | Il foglio di lavoro, il foglio di lavoro o l’indice della forma specificati non esistono. |
| 500 Internal Server Error | Si è verificato un errore imprevisto sul server. |
Errori comuni: Utilizzare un dominio di base errato (api.aspose.com) o il segmento obsoleto /autoshapes/ produrrà un errore 404. Utilizzare sempre il segmento /shapes/ con il dominio api.aspose.cloud.
Famiglia di SDK Cloud
L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a basso livello e consente di concentrarsi sulle attività del progetto. Consultare il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
Gli esempi di codice seguenti mostrano come chiamare i servizi web di Aspose.Cells utilizzando vari SDK:
Per operazioni correlate, consultare la documentazione su Aggiungere una forma e Aggiornare una forma.