Aspose.Cells Cloud – Konvertieren Sie Excel-Arbeitsmappen in PDF, CSV, HTML und weitere Formate (GET /cells/{name})
Diese REST-API ruft eine Excel-Arbeitsmappe in einem anderen Format ab.
GetWorkBook API
GET https://api.aspose.cloud/v3.0/cells/{name}
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Abfrageparameter
| Parametername | Typ | Beschreibung | Standardwert |
|---|---|---|---|
| format | string | Ziel-Dateiformat (z. B. CSV, XLS, HTML, MHTML, ODS, PDF, XML, TXT, TIFF, XLSB, XLSM, XLSX, XLTM, XLTX, XPS, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG usw.). | – |
| password | string | Kennwort, das zum Öffnen der Excel-Datei erforderlich ist. | – |
| isAutoFit | bool | Passt die Breite von Zeilen und Spalten automatisch an. | false |
| onlySaveTable | bool | Wenn true, wird nur Tabellendaten gespeichert. Akzeptiert true oder false. |
false |
| outPath | string | Pfad zum Speichern des Ergebnisses. Bei einer einzelnen Datei inklusive Dateiname und -erweiterung; bei mehreren Dateien nur der Ordnerpfad. | – |
| outStorageName | string | Name des Speichers, in dem die Ausgabedatei gespeichert wird. | – |
| checkExcelRestriction | bool | Prüft Excel-Einschränkungen beim Ändern von Zellen oder damit verbundenen Objekten. | false |
| region | string | Regionale Einstellungen, die auf die Arbeitsmappe angewendet werden. | – |
| pageWideFitOnPerSheet | bool | Passt die Seitenbreite für jedes Arbeitsblatt beim Konvertieren in PDF an. | false |
| pageTallFitOnPerSheet | bool | Passt die Seitenhöhe für jedes Arbeitsblatt beim Konvertieren in PDF an. | false |
| onePagePerSheet | bool | Erstellt eine einzelne PDF-Seite pro Arbeitsblatt. | false |
| folder | string | Ordnerpfad der ursprünglichen Arbeitsmappe. | – |
| storageName | string | Name des Speichers, in dem sich die Quelldatei befindet. | – |
Antwort
Erfolg (200)
-
Die API gibt ein Workbook-Objekt zurück, das Strukturinformationen zur Arbeitsmappe enthält, wenn der Abfrageparameter
formatweggelassen wird. -
Die API gibt die konvertierte Datei im angeforderten Format zurück, wenn der Abfrageparameter
formateinen Dateityp angibt.
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456
(binäre PDF-Daten)
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Details zum Vorgang. |
| 400 | Bad Request | Fehlende oder ungültige Parameter (z. B. nicht unterstütztes Dateiformat). |
| 401 | Unauthorized | Ungültiges oder fehlendes JWT-Token. |
| 413 | Payload Too Large | Die hochgeladene Datei überschreitet die Größeinschränkung. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Hinweise:
- Große Arbeitsmappen können länger zum Konvertieren benötigen; erwägen Sie, das Timeout für die Anfrage zu erhöhen.
- Einige Formate (z. B.
ODS) unterstützen bestimmte Excel-Funktionen wie Makros nicht.
Verwenden der GetWorkBook API mit SDKs
Voraussetzungen:
- Ein gültiges JWT-Zugriffstoken, das über den Aspose.Cells-Authentifizierungsfluss abgerufen wurde.
- Die Quell-Arbeitsmappe muss in einem unterstützten Aspose-Speicher abgelegt oder direkt in der Anfrage übermittelt werden.
- Stellen Sie sicher, dass die API-Version (
v3.0) mit der neuesten veröffentlichten Version übereinstimmt.
GetWorkBook API-Spezifikation
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.
Beispielanfrage
Sie können das cURL-Befehlszeilentool verwenden, um auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt eine korrekte GET-Anfrage mit dem erforderlichen Autorisierungsheader.
Verwenden der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist die schnellste Möglichkeit zur Entwicklung. Ein SDK abstractiert Low-Level-Details, sodass Sie sich auf Ihre Projekt-Aufgaben konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden:
Siehe auch
Zuletzt aktualisiert: 2024-12-01