Excel-Dateien sperren – Aspose.Cells Cloud API-Dokumentation

API-Version: v3.0 (aktuell)

Diese REST-API sperrt Excel-Arbeitsmappen.

PostLock API

POST https://api.aspose.cloud/v3.0/cells/lock

Voraussetzungen – Die Anforderung muss über HTTPS gesendet werden und einen gültigen OAuth 2.0-Bearer-Token im Authorization-Header enthalten.

Die Anforderungsparameter sind

Parametername	Typ	Speicherort	Beschreibung
file	Datei	Formular-Daten (multipart body)	Die hochzuladende und zu sperrende Excel-Arbeitsmappe.
password	Zeichenkette	Abfragezeichenfolge	Passwort für die Arbeitsmappe (optional).

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser heraus durchzuführen.

Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie die Cloud-API mit cURL aufgerufen wird.

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

Antwort

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Sie können eine Beispieldatei herunterladen — Sample.xlsx — um die Anforderung zu testen.

Hinweis: Die API unterstützt Dateien bis zu einer Größe von 100 MB; größere Nutzdaten können zu einer Antwort mit dem Statuscode 413 („Payload Too Large“) führen.

Antwortdetails

Feld	Typ	Beschreibung
Filename	Zeichenkette	Name der von dem Dienst zurückgegebenen gesperrten Arbeitsmappe.
FileSize	Ganzzahl	Größe der gesperrten Datei in Bytes.
FileContent	Zeichenkette (Base64)	Die gesperrte Arbeitsmappe, codiert als Base64-Zeichenkette.

Um die gesperrte Arbeitsmappe abzurufen, dekodieren Sie den FileContent-Wert von Base64 und speichern Sie ihn unter dem in der Antwort angegebenen Filename.

Fehlerbehandlung

– Die API gibt Standard-HTTP-Statuscodes (z. B. 400 Bad Request, 401 Unauthorized, 500 Internal Server Error) zusammen mit einem JSON-Fehlerobjekt zurück, das die Felder Code und Message enthält.

Cloud SDK-Familie

Die Verwendung eines SDK ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK abstrahiert niedrigstufige Details, sodass Sie sich auf die Aufgaben Ihres Projekts 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:

Ändern des Passwortschutzes einer Excel-Arbeitsmappe