Aggiungi una riga vuota a un foglio di lavoro Excel utilizzando l'API Aspose.Cells Cloud

Questa API REST consente di aggiungere una nuova riga a un foglio di lavoro Excel. Essa inserisce una riga vuota all’indice zero-based specificato.

Prerequisiti:

È necessario includere un token di accesso Aspose Cloud valido (Bearer JWT) nell’header Authorization.
Il libro di lavoro target deve essere caricato nello storage Aspose Cloud, e i parametri folder e storageName devono puntare alla sua posizione.

Note:

L’indice rowIndex è zero-based; inserire alla posizione 0 aggiunge una riga all’inizio del foglio di lavoro.
I fogli di lavoro Excel hanno un massimo di 1.048.576 righe; tentare di inserire oltre questo limite comporterà un errore.

API PutInsertWorksheetRow

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

Sicurezza e autenticazione

Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione tramite token JWT.

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file del libro di lavoro.
sheetName	string	path	Nome del foglio di lavoro.
rowIndex	integer	path	Indice zero-based in cui verrà inserita la nuova riga.
folder	string	query	Percorso della cartella nello storage contenente il libro.
storageName	string	query	Nome dello storage Aspose Cloud da utilizzare.

La specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di effettuare interazioni REST direttamente da un browser web.

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

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/10" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Nota: Tutti gli endpoint Aspose.Cells Cloud richiedono HTTPS. Utilizzare lo schema sicuro https:// per le chiamate in produzione.

Risposta

{
  "Code": 200,
  "Status": "OK"
}

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 (es. tipo di file non supportato).
401	Non autorizzato	Token JWT non valido o mancante.
413	Payload troppo grande	File caricato supera il limite di dimensione.
500	Errore interno del server	Errore imprevisto nel server.

Esempio di risposta di errore (es. quando l’indice della riga supera il limite del foglio di lavoro):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Indice riga fuori intervallo. Il numero massimo di righe consentito è 1048576."
}

Famiglia di SDK Cloud

L’utilizzo di un SDK è il modo migliore per accelerare lo sviluppo. Un SDK astrae 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 Aspose.Cells utilizzando vari SDK: