Aggiungi una forma a un foglio di calcolo Excel utilizzando l'API Aspose.Cells Cloud
Questa REST API aggiunge una forma a un foglio di calcolo Excel.
L’endpoint appartiene alla versione API v3.0; assicurati di utilizzare un token di accesso JWT ottenuto tramite il flusso OAuth2 di Aspose Cloud (client‑id/client‑secret) e di includerlo nell’intestazione Authorization: Bearer <token>.
Sicurezza e autenticazione
Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
API PutWorksheetShape
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes
Parametri della richiesta
| Nome parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
| name | string | path | Nome del documento. |
| sheetName | string | path | Nome del foglio di calcolo. |
| shapeDTO | object | body | Oggetto JSON che descrive la forma da aggiungere (vedere la specifica OpenAPI per lo schema completo). |
| drawingType | string | query | Tipo di oggetto forma (ad esempio, arc, line, rectangle). |
| upperLeftRow | integer | query | Indice della riga in alto a sinistra della forma. |
| upperLeftColumn | integer | query | Indice della colonna in alto a sinistra della forma. |
| top | integer | query | Offset verticale della forma dal suo bordo superiore, in pixel. |
| left | integer | query | Offset orizzontale della forma dal suo bordo sinistro, in pixel. |
| width | integer | query | Larghezza della forma, in pixel. |
| height | integer | query | Altezza della forma, in pixel. |
| folder | string | query | Cartella che contiene il documento. |
| storageName | string | query | Nome dello storage. |
La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono 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 una chiamata all’API Cloud con cURL.
Codici di stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta non valida | Parametri mancanti o non validi (ad esempio, tipo di file non supportato). |
| 401 | Non autorizzato | Token JWT non valido o mancante. |
| 413 | Payload troppo grande | Il file caricato supera il limite di dimensione. |
| 500 | Errore interno del server | Errore imprevisto del server. |
Le risposte di errore tipiche includono:
- 400 Richiesta non valida – parametri mancanti o non validi.
- 401 Non autorizzato – token JWT non valido o mancante.
- 404 Non trovato – il foglio di calcolo o il documento specificato non esiste.
Ogni errore viene restituito come oggetto JSON contenente i campi Code e Message.
Famiglia di SDK Cloud
L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a 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 chiamare i servizi web di Aspose.Cells utilizzando vari SDK: