Salva il Workbook di Excel – Aspose.Cells Cloud API

Questa API REST consente di salvare un file Excel in diversi formati.
Prima di chiamare questo endpoint, assicurati di avere un token di accesso OAuth 2.0 valido e che il workbook di origine sia memorizzato nella tua archiviazione Aspose Cloud.

Prerequisiti

Ottieni un token di accesso JWT e includilo nell’intestazione Authorization: Bearer <token> di ogni richiesta.
Carica il workbook di origine nell’archiviazione Aspose Cloud (oppure conferma che esista già).
Conosci il nome dell’archiviazione e il percorso della cartella in cui si trova il workbook.

API PostWorkbookSaveAs

POST https://api.aspose.cloud/v3.0/cells/{name}/saveAs

Sicurezza e autenticazione

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

Parametro del percorso

Nome parametro	Tipo	Descrizione
name	string	Nome del file Excel.

Parametro di query

Nome parametro	Tipo	Descrizione
newfilename	string	Nuovo nome del file da salvare.
isAutoFitRows	string	Se `true`, ridimensiona automaticamente tutte le righe nel workbook. Il valore predefinito è `false`.
isAutoFitColumns	string	Se `true`, ridimensiona automaticamente le larghezze delle colonne nel workbook. Il valore predefinito è `false`.
folder	string	Cartella contenente il workbook originale.
storageName	string	Nome dell’archiviazione in cui si trova il file di origine.
outStorageName	string	Nome dell’archiviazione in cui verrà salvato il file di output.
checkExcelRestriction	bool	Specifica se applicare le restrizioni di Excel durante la modifica di celle o oggetti correlati.
region	string	Impostazioni regionali applicate al workbook.
pageWideFitOnPerSheet	bool	Adatta la larghezza della pagina a ciascun foglio di calcolo durante la conversione.
pageTallFitOnPerSheet	bool	Adatta l’altezza della pagina a ciascun foglio di calcolo durante la conversione.
sheetName	string	Nome del foglio di calcolo da convertire.
pageIndex	string	Indice della pagina da convertire all’interno del foglio specificato (richiede `sheetName`).
onePagePerSheet	bool	Durante la conversione in PDF, genera una pagina per ciascun foglio di calcolo.

Parametro del corpo della richiesta

Nome parametro	Tipo	Descrizione
SaveOptions	Object	Opzioni di salvataggio fornite nella seconda parte della richiesta multipart.

Esempio di corpo della richiesta (parte JSON della richiesta multipart)

{
  "SaveOptions": {
    "SaveFormat": "pdf",
    "CompressionLevel": 9
  }
}

Risposta

L’API restituisce un oggetto SaveResponse.

{
  "Status": "OK",
  "Code": 200,
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  }
}

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.

Come usare l’API PostWorkbookSaveAs con gli SDK

Specifica dell’API PostWorkbookSaveAs

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

Puoi utilizzare cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come chiamare l’API Cloud con cURL.

Richiesta

curl -X POST "https://api.aspose.cloud/v3.0/cells/sampleBook.xlsx/SaveAs?newfilename=sample.pdf&isAutoFitRows=true&isAutoFitColumns=true" \
  -H "accept: multipart/form-data" \
  -H "Authorization: Bearer <your_jwt_token>"

Risposta

{
  "SaveResult": {
    "Documents": [
      {
        "Name": "sample.pdf",
        "Size": 10240,
        "Folder": "output",
        "Storage": "MyStorage"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello in modo che tu possa 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:

Per altri scenari di conversione, consulta le guide Converti Excel in PDF e Esporta Excel in CSV.

Converti Excel in HTML Conversione Avanzata di File Excel