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 format weggelassen wird.

  • Die API gibt die konvertierte Datei im angeforderten Format zurück, wenn der Abfrageparameter format einen 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