Massenfreigabe

Diese REST-API führt die Massenfreigabe für berechtigte Excel-Dateien durch.

REST-API

POST http://api.aspose.cloud/v3.0/cells/batch/unlock

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parametername	Typ	Speicherort	Beschreibung
BatchLockRequest		body	Anforderungstext, der die Freigabeeinstellungen enthält.

BatchLockRequest-Eigenschaften

Name	Typ	Beschreibung	Hinweise
SourceFolder	string	Ordner, der die Quell-Excel-Dateien enthält.	[optional]
MatchCondition	MatchConditionRequest	Kriterien zur Auswahl der Dateien für die Freigabe.	[optional]
Password	string	Kennwort, das für geschützte Arbeitsmappen verwendet wird.	[optional]
OutFolder	string	Zielordner für die freigegebenen Dateien.	[optional]

MatchConditionRequest-Eigenschaften

Name	Typ	Beschreibung	Hinweise
RegexPattern	string	Regulärer Ausdruck zum Abgleich von Dateinamen.	[optional]
FullMatchConditions	string[]	Exakte Dateinamensbedingungen zum Abgleich.	[optional]

Anforderungstextparameter

Parametername	Typ	Beschreibung
data	file	Binärinhalt der zu erstellenden Arbeitsmappendatei.

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 einen „created“-Status zurückgibt
400 Bad Request	Ungültige Parameter	Client-seitiger Fehler
401 Unauthorized	Fehlendes oder ungültiges Token	Authentifizierungsfehler
409 Conflict	Datei vorhanden und `isWriteOver=false`	Konflikt mit bestehender Datei

Verwendung der PostBatchLock-API mit SDKs

PostBatchLock-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 nutzen, um problemlos auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie Aufrufe an die Cloud-API mit cURL durchgeführt werden.

Anforderung

curl -v "http://api.aspose.cloud/v3.0/cells/batch/unlock" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"SourceFolder":"CellsTests","OutFolder":"Output","MatchCondition":{"RegexPattern":"(^Book)(.+)(xlsx$)"},"Password":"123456"}'

Antwort

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

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist der schnellste Weg, um Freigabefunktionen zu entwickeln. Ein SDK abstrahiert die Low-Level-Details, sodass Sie sich auf Ihre Geschäftslogik konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden: