Schützen einer Excel-Arbeitsmappe mithilfe der Aspose.Cells Cloud API
Diese REST API schützt eine Excel-Arbeitsmappe und ermöglicht es Ihnen, eine Excel-Arbeitsmappe sicher mit Passwort und Schutzeinstellungen über die Aspose.Cells Cloud zu schützen.
PostProtectDocument API
POST https://api.aspose.cloud/v3.0/cells/{name}/protection
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Abfrageparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| folder | string | Ordner, der die Quell-Arbeitsmappe enthält. (optional) |
| storageName | string | Name des Speicherorts. (optional; Standard = “Default”) |
Body-Parameter der Anforderung
| Parametername | Typ | Beschreibung |
|---|---|---|
| protection | WorkbookProtectionRequest | Objekt, das die Schutzeinstellungen für die Arbeitsmappe definiert. |
WorkbookProtectionRequest
| Parametername | Typ | Beschreibung |
|---|---|---|
| ProtectionType | string | Art des anzuwendenden Schutzes. Zulässige Werte (Groß-/Kleinschreibung wird ignoriert): ALL, CONTENTS, NONE, OBJECTS, SCENARIOS, STRUCTURE, WINDOWS. |
| Password | string | OPTIONALES Passwort zur Festlegung des Schutzes. |
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 die Größenbeschränkung. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Verwendung der PostProtectDocument API mit SDKs
Voraussetzungen
Bevor Sie die API aufrufen, stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:
- Holen Sie sich ein JWT-Zugriffstoken mithilfe des in der Sicherheitssection beschriebenen Authentifizierungsflusses.
- Laden Sie die Arbeitsmappe in Ihren Aspose Cloud-Speicher hoch oder bestätigen Sie, dass sie bereits im Zielordner vorhanden ist.
- Kennen Sie den Speichernamen (Standard ist
"Default", sofern nicht angegeben) und den genauen Dateinamen, den Sie schützen möchten.
Spezifikation der PostProtectDocument API
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser durchzuführen.
Beispiel: Schützen einer Arbeitsmappe mit cURL
-
Holen Sie sich ein Zugriffstoken wie in Voraussetzungen / Authentifizierung beschrieben.
-
Führen Sie die Anforderung aus:
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access_token>" \ -d '{ "ProtectionType": "ALL", "Password": "aspose" }'Die Antwort enthält ein Statusobjekt, das bestätigt, dass der Schutz erfolgreich war.
Verwenden der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs ist der schnellste Weg, um mit Aspose.Cells Cloud zu entwickeln. Ein SDK abstrahiert die Low-Level-Details, sodass Sie sich auf Ihre Geschäftslogik konzentrieren können. Im GitHub-Repository finden Sie eine vollständige Liste der Aspose.Cells Cloud SDKs.
Die folgenden Codebeispiele zeigen, wie Sie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufrufen:
Beispiel für vollständige Antwort
{
"Status": "OK",
"Code": 200,
"Workbook": {
"Name": "test.xlsx",
"Path": "/MyFolder/test.xlsx",
"Protection": {
"ProtectionType": "ALL",
"Password": true
}
}
}