Aspose.Cells Cloud – Konvertera Excel-arbetsbok till PDF, CSV, HTML och mer (GET /cells/{name})
Denna REST API hämtar en Excel-arbetsbok i ett annat format.
GetWorkBook API
GET https://api.aspose.cloud/v3.0/cells/{name}
Säkerhet och autentisering
Aspose.Cells Cloud API:n är säkra och kräver JWT-tokenbaserad autentisering.
Frågeparametrar
| Parameter_name | Typ | Beskrivning | Standardvärde |
|---|---|---|---|
| format | string | Mål-filformat (t.ex. CSV, XLS, HTML, MHTML, ODS, PDF, XML, TXT, TIFF, XLSB, XLSM, XLSX, XLTM, XLTX, XPS, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG, etc.). | – |
| password | string | Lösenord som krävs för att öppna Excel-filen. | – |
| isAutoFit | bool | Justerar automatiskt rad- och kolumnbredd. | false |
| onlySaveTable | bool | När true sparas endast tabelldata. Accepterar true eller false. |
false |
| outPath | string | Sökväg för att spara resultatet. För en enskild fil inkludera filnamn och filtillägg; för flera filer ange endast mappnamn. | – |
| outStorageName | string | Namn på lagringen dit utdatafilen ska sparas. | – |
| checkExcelRestriction | bool | Kontrollerar Excel-begränsningar vid ändring av celler eller relaterade objekt. | false |
| region | string | Regionala inställningar som tillämpas på arbetsboken. | – |
| pageWideFitOnPerSheet | bool | Anpassar sidbredden till varje kalkylblad vid konvertering till PDF. | false |
| pageTallFitOnPerSheet | bool | Anpassar sidhöjden till varje kalkylblad vid konvertering till PDF. | false |
| onePagePerSheet | bool | Skapar en PDF-sida per kalkylblad. | false |
| folder | string | Mappsökväg för den ursprungliga arbetsboken. | – |
| storageName | string | Namn på lagringen där källfilen finns. | – |
Svar
Lyckades (200)
-
API:n returnerar ett Workbook-objekt som innehåller arbetsbokens strukturinformation när
format-frågeparametern utelämnas. -
API:n returnerar den konverterade filen i det begärda formatet när
format-frågeparametern anger ett filtyp.
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456
(binär PDF-data)
HTTP-statuskoder
| Kod | Betydelse | Beskrivning |
|---|---|---|
| 200 | OK | Filter tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer. |
| 400 | Ogiltig förfrågan | Saknade eller ogiltiga parametrar (t.ex. ej stött filformat). |
| 401 | Auktorisering misslyckades | Ogiltig eller saknad JWT-token. |
| 413 | För stor nyttolast | Uppladdad fil överskrider storleksgränsen. |
| 500 | Internt serverfel | Oväntat serverfel. |
Anteckningar:
- Stora arbetsböcker kan ta längre tid att konvertera; överväg att öka förfrågningstimeout.
- Vissa format (t.ex.
ODS) stöds inte för vissa Excel-funktioner såsom makron.
Hur du använder GetWorkBook API med SDK:er
Förutsättningar:
- En giltig JWT-åtkomsttoken erhållen via Aspose.Cells-autentisering.
- Källarbetsboken måste lagras i en stödd Aspose-lagring eller direkt anges i förfrågan.
- Kontrollera att API-versionen (
v3.0) matchar den senast släppta versionen.
GetWorkBook API-specificering
OpenAPI-specificeringen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.
Exempelförfrågan
Du kan använda kommandoradsverktyget cURL för att komma åt Aspose.Cells webbtjänster. Följande exempel visar en korrekt GET-förfrågan med nödvändigt auktoriseringshuvud.
Använd Aspose.Cells Cloud SDK:er
Att använda en SDK är det snabbaste sättet att utveckla. En SDK abstraher bort detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Se GitHub-lagringsplatsen för en komplett lista över Aspose.Cells Cloud SDK:er.
Följande kodexempel visar hur man anropar Aspose.Cells webbtjänster med olika SDK:er:
Se även
Senast uppdaterad: 2024-12-01