Excel-Arbeitsmappe speichern – Aspose.Cells Cloud API
Diese REST API ermöglicht es Ihnen, eine Excel-Datei in verschiedenen Formaten zu speichern.
Bevor Sie diesen Endpunkt aufrufen, stellen Sie sicher, dass Sie über ein gültiges OAuth 2.0-Access-Token verfügen und sich die Quell-Arbeitsmappe in Ihrem Aspose Cloud-Speicher befindet.
Voraussetzungen
- Beschaffen Sie ein JWT-Access-Token und fügen Sie es in den
Authorization: Bearer <token>-Header jeder Anfrage ein. - Laden Sie die Quell-Arbeitsmappe in den Aspose Cloud-Speicher hoch (oder bestätigen Sie, dass sie bereits vorhanden ist).
- Kennen Sie den Speichernamen und den Ordnerpfad, in dem sich die Arbeitsmappe befindet.
PostWorkbookSaveAs API
POST https://api.aspose.cloud/v3.0/cells/{name}/saveAs
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Pfadparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| name | string | Der Name der Excel-Datei. |
Abfrageparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| newfilename | string | Neuer Dateiname für das gespeicherte Dokument. |
| isAutoFitRows | string | Wenn true, werden alle Zeilen in der Arbeitsmappe automatisch angepasst. Standard ist false. |
| isAutoFitColumns | string | Wenn true, werden die Spaltenbreiten in der Arbeitsmappe automatisch angepasst. Standard ist false. |
| folder | string | Ordner, der die ursprüngliche Arbeitsmappe enthält. |
| storageName | string | Name des Speichers, in dem sich die Quelldatei befindet. |
| outStorageName | string | Name des Speichers, in dem die Ausgabedatei gespeichert wird. |
| checkExcelRestriction | bool | Gibt an, ob Excel-Einschränkungen beim Ändern von Zellen oder zugehörigen Objekten erzwungen werden sollen. |
| region | string | Regionale Einstellungen, die auf die Arbeitsmappe angewendet werden. |
| pageWideFitOnPerSheet | bool | Passt die Seitenbreite an jedes Arbeitsblatt an, wenn konvertiert wird. |
| pageTallFitOnPerSheet | bool | Passt die Seitenhöhe an jedes Arbeitsblatt an, wenn konvertiert wird. |
| sheetName | string | Name des Arbeitsblatts, das konvertiert werden soll. |
| pageIndex | string | Index der Seite, die innerhalb des angegebenen Arbeitsblatts konvertiert werden soll (erfordert sheetName). |
| onePagePerSheet | bool | Generiert beim Konvertieren in PDF eine Seite pro Arbeitsblatt. |
Anforderungstextparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| SaveOptions | Object | Speicheroptionen, die im zweiten Teil der Multipart-Anfrage übergeben werden. |
Beispiel für Anforderungstext (JSON-Teil der Multipart-Anfrage)
{
"SaveOptions": {
"SaveFormat": "pdf",
"CompressionLevel": 9
}
}
Antwort
Die API gibt ein SaveResponse-Objekt zurück.
{
"Status": "OK",
"Code": 200,
"SaveResult": {
"Documents": [
{
"Name": "sample.pdf",
"Size": 10240,
"Folder": "output",
"Storage": "MyStorage"
}
]
}
}
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ützter Dateityp). |
| 401 | Unauthorized | Ungültiges oder fehlendes JWT-Token. |
| 413 | Payload Too Large | Die hochgeladene Datei überschreitet das Größenlimit. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Verwendung der PostWorkbookSaveAs API mit SDKs
PostWorkbookSaveAs API-Spezifikation
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.
Sie können cURL verwenden, um problemlos auf Aspose.Cells-Webservices zuzugreifen. Das folgende Beispiel zeigt, wie die Cloud-API mit cURL aufgerufen wird.
Verwendung der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist der beste Weg, die Entwicklungszeit zu verkürzen. Ein SDK übernimmt die Low-Level-Details, sodass Sie sich auf Ihre Projekt-Aufgaben konzentrieren können. Schauen Sie sich das GitHub-Repository für eine vollständige Liste der Aspose.Cells Cloud SDKs an.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mithilfe verschiedener SDKs aufgerufen werden:
Weitere Konvertierungsszenarien finden Sie in den Anleitungen Konvertieren von Excel in PDF und Exportieren von Excel in CSV.