Converti Excel in JSON usando l'API REST di Aspose.Cells Cloud – Guida rapida

API REST

Questa API REST converte un file di foglio di calcolo in un file in formato JSON.

POST https://api.aspose.cloud/v3.0/cells/convert/json

Sicurezza e autenticazione

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

Richiesta

Parametri di query

Nome del parametro	Tipo	Descrizione
`password`	string	Password necessaria per aprire il file Excel (opzionale).
`storageName`	string	Nome dello storage in cui si trova il file (opzionale).
`checkExcelRestriction`	bool	Applica restrizioni specifiche di Excel alla modifica delle celle (opzionale).

Parametro nel corpo della richiesta

Nome del parametro	Tipo	Descrizione
`datafile`	file	Il file Excel da caricare. Deve essere inviato come prima parte di una richiesta `multipart/form-data`.

Esempio di chiamata cURL

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Risposta

Il servizio restituisce un oggetto FileInfo. I campi principali sono descritti di seguito:

Campo	Tipo	Descrizione
`Filename`	string	Nome del file JSON generato (ad esempio, `myWorkbook.json`).
`FileSize`	integer	Dimensione del file generato in byte.
`FileContent`	string	Contenuto del file JSON codificato in Base64. Decodificarlo per ottenere il JSON effettivo.

Esempio di risposta

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (stringa in base64) ..."
}

Gestione degli errori

Se la richiesta ha esito negativo, l’API restituisce un oggetto di errore con la seguente struttura:

Campo	Tipo	Descrizione
`Code`	string	Identificatore dell’errore leggibile da macchina.
`Message`	string	Descrizione leggibile dell’errore.

Codici di stato HTTP comuni:

400 – Richiesta non valida (ad esempio, file mancante o parametri non validi).
401 – Non autorizzato (token di accesso non valido o mancante).
500 – Errore interno del server.

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 PostConvertWorkbookToJson con gli SDK

Specifica dell’API PostConvertWorkbookToJson

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 chiamate all’API Cloud con cURL.

Richiesta

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "accept: application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "File=@myWorkbook.xlsx"

Risposta

{
  "Filename": "myWorkbook.json",
  "FileSize": 8423,
  "FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH... (stringa in base64)"
}

Utilizzare gli SDK di Aspose.Cells Cloud

L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce 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 effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Altre API che implementano funzionalità simili

POST /cells/{name}/saveAs – Salva un file Excel come file HTML con impostazioni aggiuntive e memorizza il risultato nello storage specificato.
PUT /cells/convert – Converte un file Excel in un file HTML con impostazioni aggiuntive e restituisce il risultato nella risposta.
GET /cells/{name} – Recupera un file Excel; può essere utilizzato con parametri di query per ottenere il file in formato HTML.

Converti Excel in HTML