Konvertieren Sie Excel in JSON mit der Aspose.Cells Cloud API – Schnellleitfaden
REST API
Diese REST API konvertiert eine Tabellenkalkulationsdatei in eine im JSON-Format formatierte Datei.
POST https://api.aspose.cloud/v3.0/cells/convert/json
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anfrage
Abfrageparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
password |
string | Kennwort zum Öffnen der Excel-Datei (optional). |
storageName |
string | Name des Speichers, in dem sich die Datei befindet (optional). |
checkExcelRestriction |
bool | Erzwingt Excel-spezifische Einschränkungen beim Ändern von Zellen (optional). |
Anfragetextparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
datafile |
file | Die hochzuladende Excel-Datei. Muss als erster Teil einer multipart/form-data-Anfrage gesendet werden. |
Beispiel cURL-Aufruf
curl -X POST "https://api.aspose.cloud/v3.0/cells/convert/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "accept: application/json" \
-H "Content-Type: multipart/form-data" \
-F "File=@myWorkbook.xlsx"
Antwort
Der Dienst gibt ein FileInfo-Objekt zurück. Die wichtigsten Felder sind wie folgt beschrieben:
| Feld | Typ | Beschreibung |
|---|---|---|
Filename |
string | Name der generierten JSON-Datei (z. B. myWorkbook.json). |
FileSize |
integer | Größe der generierten Datei in Bytes. |
FileContent |
string | Base64-codierter Inhalt der JSON-Datei. Decodieren Sie, um den eigentlichen JSON-Inhalt abzurufen. |
Beispielantwort
{
"Filename": "myWorkbook.json",
"FileSize": 8423,
"FileContent": "eyJmb3JtYXR0ZWRfZGF0YSI6IH ... (Base64-Zeichenfolge) ..."
}
Fehlerbehandlung
Falls die Anfrage fehlschlägt, gibt die API ein Fehlerobjekt mit folgender Struktur zurück:
| Feld | Typ | Beschreibung |
|---|---|---|
Code |
string | Maschinenlesbarer Fehlerbezeichner. |
Message |
string | Menschlich lesbare Beschreibung des Fehlers. |
Häufige HTTP-Statuscodes:
- 400 – Bad Request (z. B. fehlende Datei, ungültige Parameter).
- 401 – Unauthorized (ungültiger oder fehlender Zugriffstoken).
- 500 – Internal Server Error.
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ültiger oder fehlender JWT-Token. |
| 413 | Payload Too Large | Die hochgeladene Datei überschreitet das Größenlimit. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
So verwenden Sie die PostConvertWorkbookToJson API mit SDKs
PostConvertWorkbookToJson API-Spezifikation
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt über einen Webbrowser.
Sie können das Kommandozeilentool cURL verwenden, um Aspose.Cells-Webdienste einfach aufzurufen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud API durchführen.
Verwenden der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt Details auf niedriger Ebene, sodass Sie sich auf Ihre Projektaufgaben konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webdienste mithilfe verschiedener SDKs durchgeführt werden:
Weitere APIs mit ähnlicher Funktionalität
- POST /cells/{name}/saveAs – Speichert eine Excel-Datei als HTML-Datei mit zusätzlichen Einstellungen und speichert das Ergebnis im angegebenen Speicher.
- PUT /cells/convert – Konvertiert eine Excel-Datei mit zusätzlichen Einstellungen in eine HTML-Datei und gibt das Ergebnis in der Antwort zurück.
- GET /cells/{name} – Ruft eine Excel-Datei ab; kann mit Abfrageparametern verwendet werden, um die Datei im HTML-Format zu erhalten.