Excel-Dateien im Batch schützen
Diese REST-API ermöglicht die Batch-Schützung berechtigter Excel-Dateien.
REST-API
POST http://api.aspose.cloud/v3.0/cells/batch/protect
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter
| Parametername | Typ | Ort | Beschreibung |
|---|---|---|---|
| batchProtectRequest | BatchProtectRequest | body | JSON-Payload, der den Quellordner, die Übereinstimmungsbedingungen, den Schutztyp, das Passwort und den Ausgabefolder angibt. |
BatchProtectRequest-Eigenschaften
| Name | Typ | Beschreibung | Hinweise |
|---|---|---|---|
| SourceFolder | string | Ordner, der die Quell-Excel-Dateien enthält. | optional |
| MatchCondition | MatchConditionRequest | Kriterien zur Auswahl der zu schützenden Dateien. | optional |
| ProtectionType | string | Art des anzuwendenden Schutzes (z. B. All, ReadOnly). |
optional |
| Password | string | Passwort, das für die geschützten Dateien festgelegt werden soll. | optional |
| OutFolder | string | Zielordner für die geschützten Dateien. | optional |
MatchConditionRequest-Eigenschaften
| Name | Typ | Beschreibung | Hinweise |
|---|---|---|---|
| RegexPattern | string | Regulärer Ausdruck zur Übereinstimmung mit Dateinamen. | optional |
| FullMatchConditions | string[] | Liste exakter Dateinamenbedingungen. | optional |
Anforderungstextparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| data | file | Binärinhalt der zu erstellenden Arbeitsmappe. |
Antwort
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
HTTP-Statuscodes
| Code | Bedeutung | Wann zurückgegeben |
|---|---|---|
| 200 OK | Arbeitsmappe erfolgreich erstellt | Normaler Ablauf |
| 201 Created | Arbeitsmappe erstellt (Alternative Antwort) | Wenn die API den „Created“-Status zurückgibt |
| 400 Bad Request | Ungültige Parameter | Client-seitiger Fehler |
| 401 Unauthorized | Fehlendes oder ungültiges Token | Authentifizierungsfehler |
| 409 Conflict | Datei existiert und isWriteOver=false |
Konflikt mit vorhandener Datei |
So verwenden Sie die PostProtectConvert-API mit SDKs
PostProtectConvert-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 Aspose.Cells-Webdienste einfach aufzurufen. Das folgende Beispiel zeigt, wie ein Aufruf an die Cloud-API mit cURL durchgeführt wird.
Aspose.Cells Cloud SDKs verwenden
Die Verwendung eines SDKs ist der beste Weg, um die Entwicklungszeit zu verkürzen. Ein SDK übernimmt die Details auf niedriger Ebene und lässt Sie sich auf Ihre Projektaufgaben konzentrieren. Bitte 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 mit verschiedenen SDKs durchgeführt werden: