Aspose.Cells Cloud – Convertire il Workbook Excel in PDF, CSV, HTML e Altro (GET /cells/{name})

Questa API REST recupera un workbook Excel in un formato diverso.

API GetWorkBook

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

Sicurezza e autenticazione

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

Parametri della query

Nome parametro Tipo Descrizione Valore predefinito
format string Format del file di destinazione (ad esempio, CSV, XLS, HTML, MHTML, ODS, PDF, XML, TXT, TIFF, XLSB, XLSM, XLSX, XLTM, XLTX, XPS, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG, ecc.). –
password string Password necessaria per aprire il file Excel. –
isAutoFit bool Adatta automaticamente la larghezza di righe e colonne. false
onlySaveTable bool Se true, vengono salvati solo i dati della tabella. Accetta true o false. false
outPath string Percorso in cui salvare il risultato. Per un singolo file, includere nome file ed estensione; per più file, specificare solo la cartella. –
outStorageName string Nome dello storage in cui verrà salvato il file di output. –
checkExcelRestriction bool Verifica le restrizioni di Excel durante la modifica di celle o oggetti correlati. false
region string Impostazioni regionali applicate al workbook. –
pageWideFitOnPerSheet bool Adatta la larghezza della pagina a ciascun foglio di calcolo durante la conversione in PDF. false
pageTallFitOnPerSheet bool Adatta l’altezza della pagina a ciascun foglio di calcolo durante la conversione in PDF. false
onePagePerSheet bool Genera una pagina PDF per ciascun foglio di calcolo. false
folder string Percorso della cartella del workbook originale. –
storageName string Nome dello storage in cui si trova il file di origine. –

Risposta

Successo (200)

  • L’API restituisce un oggetto Workbook contenente informazioni sulla struttura del workbook quando il parametro di query format è omesso.

  • L’API restituisce il file convertito nel formato richiesto quando il parametro di query format specifica un tipo di file.

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456

(dati binari PDF)

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 nel server.

Note:

  • Workbook di grandi dimensioni potrebbero richiedere più tempo per essere convertiti; considerare l’aumento del timeout della richiesta.
  • Alcuni formati (ad esempio, ODS) non sono supportati per determinate funzionalità di Excel, come le macro.

Come utilizzare l’API GetWorkBook con gli SDK

Prerequisiti:

  • Un token di accesso JWT valido ottenuto tramite il flusso di autenticazione di Aspose.Cells.
  • Il workbook di origine deve essere archiviato in uno storage supportato da Aspose o fornito direttamente nella richiesta.
  • Assicurarsi che la versione dell’API (v3.0) corrisponda all’ultima versione rilasciata.

Specifica dell’API GetWorkBook

La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

Esempio di richiesta

È possibile utilizzare lo strumento a riga di comando cURL per accedere ai servizi web di Aspose.Cells. L’esempio seguente mostra una richiesta GET corretta con l’header di autorizzazione obbligatorio.

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK rappresenta il metodo più rapido per sviluppare. Un SDK astrae i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per l’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:

Vedi anche

Ultimo aggiornamento: 2024-12-01

Converti Excel in HTML Salva il Workbook di Excel – Aspose.Cells Cloud API