Converti Excel in PDF – Aspose.Cells Cloud API
Questa API REST converte un file di foglio elettronico in un file in formato PDF. Prerequisiti: ottenere un token di accesso JWT valido, assicurarsi che il file Excel di origine sia memorizzato in uno storage supportato e disporre delle autorizzazioni appropriate per richiamare l’endpoint di conversione.
API PostConvertWorkbookToPDF
POST https://api.aspose.cloud/v3.0/cells/convert/pdf
Sicurezza e autenticazione
Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione tramite token JWT.
Parametro di query
| Nome parametro | Tipo | Descrizione |
|---|---|---|
| password | string | Password per aprire il file Excel. |
| storageName | string | Nome dello storage in cui è posizionato il file. |
| checkExcelRestriction | bool | Indica se applicare le restrizioni sui file Excel quando si modificano oggetti correlati alle celle. |
Se omesso, checkExcelRestriction assume valore false per impostazione predefinita.
Parametro nel corpo della richiesta
| Nome parametro | Tipo | Descrizione |
|---|---|---|
| datafile | file | File di dati salvato come prima parte del contenuto multipart. |
Risposta
La risposta restituisce un oggetto JSON contenente i metadati del file. Il file PDF può essere scaricato tramite il campo FileContent (in base64) oppure seguendo il link fornito in FileInfo. L’API restituisce un oggetto JSON di tipo FileInfo:
- FileInfo – oggetto contenente il nome, la dimensione e il contenuto in base64 del file PDF generato.
{
"Filename": "esempio.pdf",
"FileSize": 12345,
"FileContent": "stringa_in_base64"
}
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 es. 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. |
Come utilizzare l’API PostConvertWorkbookToPDF con gli SDK
Specifica dell’API PostConvertWorkbookToPDF
La Specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare direttamente interazioni REST da un browser web.
Intestazioni della richiesta
| Intestazione | Tipo | Descrizione |
|---|---|---|
| Authorization | string | Token Bearer ottenuto tramite autenticazione JWT. |
| Content-Type | string | Deve essere multipart/form-data per il caricamento dei file. |
| Accept | string | application/json per ricevere i metadati della risposta. |
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. Includi un token di accesso nell’intestazione Authorization ed esegui la richiesta riportata di seguito.
Utilizzo degli SDK Aspose.Cells Cloud
L’utilizzo di un SDK semplifica lo sviluppo gestendo automaticamente i dettagli di basso livello. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web Aspose.Cells utilizzando vari SDK:
Altre API che implementano questa funzionalità
| API | Tipo | Descrizione | Link Swagger |
|---|---|---|---|
| /cells/convert | PUT | Converte una cartella di lavoro dal contenuto della richiesta in un formato specificato. | PutConvertWorkBook |
L’API POST /cells/{name}/saveAs consente di salvare un file MS Excel come PDF con impostazioni aggiuntive e memorizzare il risultato nello storage.
Questa API REST converte un file Excel in PDF.
L’API PUT /cells/convert consente di convertire un file MS Excel in PDF con impostazioni aggiuntive e restituire il risultato nella risposta.
L’API GET /cells/{name} consente di convertire un file MS Excel in PDF con impostazioni aggiuntive e restituire il risultato nella risposta.
Queste API PutConvertWorkBook, GetWorkBook e PostDocumentSaveAs definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di effettuare direttamente interazioni REST da un browser web.
Per ulteriori opzioni di conversione, consulta la pagina Opzioni di salvataggio.