Excel-Arbeitsmappe mit Aspose.Cells Cloud API verschlüsseln – cURL- und SDK-Beispiele

Diese REST API verschlüsselt eine Excel-Arbeitsmappe.

Voraussetzungen: Sie müssen über ein gültiges JWT-Token verfügen und die Arbeitsmappe zuvor in einem Speicherort hochgeladen haben, bevor Sie diesen Endpunkt aufrufen.

PostEncryptDocument API

POST https://api.aspose.cloud/v3.0/cells/{name}/encryption

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Abfrageparameter

Parametername	Typ	Erforderlich	Beschreibung
folder	string	✗	Pfad des Ordners mit der ursprünglichen Arbeitsmappe.
storageName	string	✗	Name des zu verwendenden Speichers.

Parameter im Anforderungstext

Parametername	Typ	Erforderlich	Beschreibung
encryption	WorkbookEncryptionRequest	✓	Verschlüsselungseinstellungen für die Arbeitsmappe.

WorkbookEncryptionRequest

Parametername	Typ	Erforderlich	Beschreibung
EncryptionType	string	✓	Verschlüsselungsalgorithmus. Siehe die nachfolgende Tabelle für unterstützte Werte und deren Bedeutung.
KeyLength	integer	✗	Länge des Verschlüsselungsschlüssels in Bit (wird für `XOR` und `Compatible` ignoriert).
Password	string	✓	Passwort, das für die Verschlüsselung verwendet wird.

Werte für EncryptionType

Wert	Beschreibung
`XOR`	Einfacher XOR-Algorithmus (veraltet, niedrige Sicherheit).
`Compatible`	Excel 97‑2003-kompatible Verschlüsselung (40‑Bit).
`EnhancedCryptographicProviderV1`	AES‑128 mit SHA‑1-Hash.
`StrongCryptographicProvider`	AES‑256 mit SHA‑512-Hash (stärkste Verschlüsselung).

Antwort

{
  "Status":"OK",
  "Code":200
}

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.

Verwenden der PostEncryptDocument API mit SDKs

PostEncryptDocument API-Spezifikation

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Im folgenden Beispiel wird gezeigt, wie ein Aufruf der Cloud-API mit cURL erfolgt.

Anforderung

# Verschlüsseln der Arbeitsmappe "test.xlsx" mit dem XOR-Algorithmus (128‑Bit-Schlüssel) und dem Passwort "mateen".
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/encryption" \
     -H "accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <access_token>" \
     -d '{ "EncryptionType": "XOR", "KeyLength": 128, "Password": "mateen"}'

Antwort

{
  "Code": "200",
  "Status": "OK"
}

Mögliche Fehlerantworten

HTTP-Status	Code	Nachricht
400	BadRequest	Fehlende oder ungültige Parameter.
401	Unauthorized	Authentifizierungstoken fehlt oder ist ungültig.
403	Forbidden	Unzureichende Berechtigungen für den Zugriff auf den Speicher.
500	InternalServerError	Unerwarteter Serverfehler.

Verwenden 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 die Aufgaben Ihres Projekts konzentrieren können. Ein vollständiges Listing der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden:

Schützen einer Excel-Arbeitsmappe mit der Aspose.Cells Cloud API