Konvertera Excel till JSON med Aspose.Cells Cloud API – Snabbhandbok
REST API
Detta REST API konverterar en kalkylbladsfil till en JSON-formaterad fil.
POST https://api.aspose.cloud/v3.0/cells/convert/json
Säkerhet och autentisering
Aspose.Cells Cloud API:n är säkra och kräver JWT-tokenbaserad autentisering.
Begäran
Frågeparametrar
| Parameter namn | Typ | Beskrivning |
|---|---|---|
password |
sträng | Lösenord som krävs för att öppna Excel-filen (valfritt). |
storageName |
sträng | Namn på lagringen där filen finns (valfritt). |
checkExcelRestriction |
bool | Tvingar Excel-specifika restriktioner vid redigering av celler (valfritt). |
Begärans brödtextparameter
| Parameter namn | Typ | Beskrivning |
|---|---|---|
datafile |
fil | Den Excel-fil som ska laddas upp. Måste skickas som första del i en multipart/form-data-begäran. |
Exempel på cURL-anrop
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"
Svar
Tjänsten returnerar ett FileInfo-objekt. De viktiga fälten beskrivs nedan:
| Fält | Typ | Beskrivning |
|---|---|---|
Filename |
sträng | Namn på den genererade JSON-filen (t.ex. myWorkbook.json). |
FileSize |
heltal | Storlek på den genererade filen i byte. |
FileContent |
sträng | Base64-kodat innehåll i JSON-filen. Dekod för att hämta faktiskt JSON. |
Exempel på svar
{
"Filename": "myWorkbook.json",
"FileSize": 8423,
"FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (base64-sträng) ..."
}
Felhantering
Om begäran misslyckas returnerar API:t ett felobjekt med följande struktur:
| Fält | Typ | Beskrivning |
|---|---|---|
Code |
sträng | Maskinläsbar felidentifierare. |
Message |
sträng | Mänsklig läsbar beskrivning av felet. |
Vanliga HTTP-statuskoder:
- 400 – Dålig begäran (t.ex. saknad fil, ogiltiga parametrar).
- 401 – Ej auktoriserad (ogiltig eller saknad åtkomsttoken).
- 500 – Internt serverfel.
HTTP-statuskoder
| Kod | Betydelse | Beskrivning |
|---|---|---|
| 200 | OK | Filter tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer. |
| 400 | Dålig begäran | Saknas eller ogiltiga parametrar (t.ex. filtyp som inte stöds). |
| 401 | Ej auktoriserad | Ogiltig eller saknad JWT-token. |
| 413 | Payload för stor | Den uppladdade filen överskrider storleksgränsen. |
| 500 | Internt serverfel | Oväntat serverfel. |
Hur du använder PostConvertWorkbookToJson API med SDK:er
PostConvertWorkbookToJson API-specifikation
OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.
Du kan använda kommandoradsverktyget cURL för enkelt att komma åt Aspose.Cells-webbtjänster. Följande exempel visar hur du gör anrop till moln-API:et med cURL.
Använd Aspose.Cells Cloud SDK:er
Att använda ett SDK är det bästa sättet att påskynda utvecklingen. Ett SDK hanterar detaljer på lågnivå så att du kan fokusera på dina projektuppgifter. Se GitHub-arkivet för en komplett lista över Aspose.Cells Cloud SDK:er.
Följande kodexempel visar hur du gör anrop till Aspose.Cells-webbtjänster med olika SDK:er:
Andra API:er som implementerar liknande funktionalitet
- POST /cells/{name}/saveAs – Sparar en Excel-fil som en HTML-fil med ytterligare inställningar och lagrar resultatet i den angivna lagringen.
- PUT /cells/convert – Konverterar en Excel-fil till en HTML-fil med ytterligare inställningar och returnerar resultatet i svaret.
- GET /cells/{name} – Hämtar en Excel-fil; kan användas med frågeparametrar för att få filen i HTML-format.