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.