Der ConvertSpreadsheetToCsv-Endpunkt liest eine Tabellenkalkulationsdatei ein, die von einem lokalen Laufwerk hochgeladen wurde, führt die Konvertierung vollständig auf den Aspose.Cells Cloud-Servern durch und gibt die resultierende CSV-Datei als Binärstream zurück. Dies cloudnative Vorgehen eliminiert die Notwendigkeit, die Quelldatei in den Cloud-Speicher hochzuladen, reduziert die Speicherkosten und vereinfacht den Workflow für Entwickler, die schnelle Tabellenkalkulations-zu-CSV-Transformationen benötigen. Die unterstützten Formate hängen von den zugrunde liegenden Bibliotheken ab, und für das Lesen der Quelldatei sind entsprechende Berechtigungen erforderlich. Fehler wie fehlende Dateien, ungültige Anfragen oder Konvertierungsfehler werden mit standardmäßigen HTTP-Statuscodes zurückgegeben.
Convert Spreadsheet To CSV API
PUT https://api.aspose.cloud/v4.0/cells/convert/spreadsheet/csv
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter:
| Parametername | Typ | Speicherort | Erforderlich | Beschreibung |
|---|---|---|---|---|
| Spreadsheet | Datei | FormData | Erforderlich | Die zu konvertierende Tabellenkalkulationsdatei. Akzeptiert gängige Formate wie .xls, .xlsx, .xlsm. Muss als multipart/form-data bereitgestellt werden. Beispiel: myWorkbook.xlsx. |
| outPath | String | Query | Optional | Zielordnerpfad, in dem die konvertierte CSV gespeichert werden soll. Falls weggelassen, wird die CSV direkt im Antworttext zurückgegeben. Beispiel: /output/reports/. |
| outStorageName | String | Query | Optional | Name des Cloud-Speicherdienstes, in dem die Ausgabedatei gespeichert werden soll. Falls nicht angegeben, wird der für das Aspose.Cells-Konto konfigurierte Standardspeicher verwendet. |
| fontsLocation | String | Query | Optional | Pfad zu einem Ordner mit benutzerdefinierten Schriftarten, die von der Tabellenkalkulation benötigt werden. Ermöglicht die korrekte Darstellung von Zellen mit nicht-standardmäßigen Schriftarten. |
| region | String | Query | Optional | Regionale/Spracheinstellung der Tabellenkalkulation (z. B. de-DE, en-US, fr-FR). Beeinflusst Zahlenformatierung, Datumsauswertung und länderspezifisches Verhalten. |
| password | String | Query | Optional | Passwort zum Öffnen passwortgeschützter Tabellenkalkulationen. Wenn die Datei verschlüsselt ist und das Passwort fehlt oder falsch ist, wird ein Fehler 400/401 zurückgegeben. |
Antwort
Im Erfolgsfall gibt die API HTTP 200 (oder 202 bei asynchroner Verarbeitung) mit dem Header Content-Type: application/octet-stream zurück. Der Antworttext enthält die generierte CSV-Datei als Binärstream.
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Operationsdetails. |
| 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. |
Wann sollten Sie die Convert Spreadsheet To CSV API verwenden?
- Datenexport für Berichtssysteme – Generieren Sie CSV-Exporte aus Excel-basierten Berichten, um BI-Tools oder Data-Warehouses ohne manuellen Dateiaufwand zu versorgen.
- Automatisierte Batchverarbeitung – Konvertieren Sie große Mengen lokal gespeicherter Tabellenkalkulationen in CSV in einem serverseitigen Job und streamen Sie die Ergebnisse direkt an nachgelagerte Dienste weiter.
- Webanwendungen mit Datei-Uploads – Ermöglichen Sie Endbenutzern das Hochladen einer Excel-Datei und erhalten Sie sofort eine CSV-Version für weitere Analysen oder den Import in andere Plattformen.
- Integration veralteter Systeme – Übersetzen Sie veraltete Tabellenkalkulationsformate in CSV für Systeme, die nur einfache, durch Trennzeichen getrennte Textdateien akzeptieren.
Warum die Convert Spreadsheet To CSV API verwenden?
- Zero-Upload-Architektur – Keine Notwendigkeit, die Quelldatei im Cloud-Speicher zu speichern; die Konvertierung erfolgt direkt aus dem hochgeladenen Stream, was Zeit und Speicherkosten spart.
- Hochleistungs-Cloudverarbeitung – Nutzt die optimierte Konvertierungs-Engine von Aspose.Cells auf skalierbaren Cloud-Servern und liefert schnelle CSV-Ausgaben, auch bei großen Arbeitsmappen.
- Einfache Integration – Einzelner PUT-Request mit optionalen Abfrageparametern; gibt die CSV als sofort herunterladbaren Binärstream zurück, wodurch Nachbearbeitungsschritte entfallen.
- Vollständige Funktionsunterstützung – Verarbeitet passwortgeschützte Dateien, benutzerdefinierte Schriftarten und länderspezifische Einstellungen und gewährleistet so eine präzise Konvertierung auch für komplexe Tabellenkalkulationen.
Wie Sie die Convert Spreadsheet To CSV API mit SDKs verwenden
Convert Spreadsheet To CSV API-Spezifikation
Die Convert Spreadsheet To CSV API-Spezifikation bietet eine öffentlich zugängliche Programmierschnittstelle zur Durchführung von REST-Interaktionen direkt aus einem Webbrowser.
Sie können das cURL-Befehlszeilentool verwenden, um einfach auf die Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen.
Verwendung der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist der schnellste Weg zur Entwicklung, da sie die Details der niedrigen Ebene abstrahiert und es Ihnen ermöglicht, mit Tabellenkalkulationen über prägnanten Code zu arbeiten. Weitere Informationen finden Sie im GitHub-Repository für eine vollständige Liste der Aspose.Cells Cloud SDKs. Die folgenden Codebeispiele zeigen, wie Sie mit verschiedenen SDKs auf die Aspose.Cells-Webdienste zugreifen: