Excel-Dateien schützen

Diese REST-API schützt Excel-Dateien.

REST API

POST http://api.aspose.cloud/v3.0/cells/protect

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parametername	Typ	Speicherort	Beschreibung
file	Datei	formData (body)	Hochzuladende Datei
password	Zeichenfolge	Abfragezeichenfolge (`password`)	Passwort zum Schutz der Arbeitsmappe

Antwort

{
  "Status":"OK",
  "Code":200,
  "Files": [
    {
      "Filename": "geschützter Dateiname: smaple1.xlsx",
      "FileSize": Größe,
      "FileContent": "-----Base64-Zeichenfolge von sample1-----"
    },
    {
      "Filename": "geschützter Dateiname: sample2.xlsx",
      "FileSize": Größe,
      "FileContent": "-----Base64-Zeichenfolge von sample2-----"
    }
  ]
}

HTTP-Statuscodes

Code	Bedeutung	Beschreibung
200	OK	Filter erfolgreich angewendet; Antwort enthält Details zur Operation.
400	Ungültige Anforderung	Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp).
401	Nicht autorisiert	Ungültiges oder fehlendes JWT-Token.
413	Anforderungstext zu groß	Hochgeladene Datei überschreitet das Größenlimit.
500	Interner Serverfehler	Unerwarteter Serverfehler.

Verwendung der PostProtect-API mit SDKs

PostProtect-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 einfach auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie die Cloud-API mit cURL aufgerufen wird.

Anforderung

curl -v "http://api.aspose.cloud/v3.0/cells/protect?password=MySecretPwd" \
  -X POST \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@sample1.xlsx' \
  -F 'file2=@sample2.xlsx'

Antwort

{
  "Files": [
    {
      "Filename": "sample1.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64-Zeichenfolge von sample1-----"
    },
    {
      "Filename": "sample2.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64-Zeichenfolge von sample2-----"
    }
  ]
}

Fehlerbehandlung

– Die API kann die folgenden Statuscodes zurückgeben:

HTTP-Code	Bedeutung	Beispiel-JSON-Fehlerpayload
400	Ungültige Anforderung (z. B. fehlende Datei)	`{"Code":400,"Message":"Datei ist erforderlich."}`
401	Nicht autorisiert (ungültiges oder fehlendes Token)	`{"Code":401,"Message":"Ungültiges Zugriffstoken."}`
403	Verboten (unzureichende Berechtigungen)	`{"Code":403,"Message":"Zugriff verweigert."}`
500	Interner Serverfehler	`{"Code":500,"Message":"Unerwarteter Serverfehler."}`

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist die schnellste Möglichkeit zur Entwicklung. Ein SDK übernimmt die Details der unteren Schicht, sodass Sie sich auf Ihre Projektziele 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 Aspose.Cells-Webdienste mithilfe verschiedener SDKs aufgerufen werden:

Entschlüsseln einer Excel-Arbeitsmappe