Protect Excel Files

This REST API protects Excel files.

REST API

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

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

Request parameters

Parameter Name Type Location Description
file file formData (body) File to upload
password string query string (password) Password used to protect the workbook

Response

{
  "Status":"OK",
  "Code":200,
  "Files": [
    {
      "Filename": "protected filename: smaple1.xlsx",
      "FileSize": size,
      "FileContent": "-----Base64String of sample1-----"
    },
    {
      "Filename": "protected filename: sample2.xlsx",
      "FileSize": size,
      "FileContent": "-----Base64String of sample2-----"
    }
  ]
}

Http Status Codes

Code Meaning Description
200 OK Compression succeeded; response contains compressed file details.
400 Bad Request Missing or invalid parameters (e.g., unsupported file type).
401 Unauthorized Invalid or missing JWT token.
413 Payload Too Large Uploaded file exceeds size limit.
500 Internal Server Error Unexpected server error.

How to Use the PostProtect API with SDKs

PostProtect API Specification

The OpenAPI Specification defines a publicly accessible programming interface and lets you perform REST interactions directly from a web browser.

You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to call the Cloud API with cURL.

Error handling

– The API can return the following status codes:

HTTP Code Meaning Example JSON error payload
400 Bad request (e.g., missing file) {"Code":400,"Message":"File is required."}
401 Unauthorized (invalid or missing token) {"Code":401,"Message":"Invalid access token."}
403 Forbidden (insufficient permissions) {"Code":403,"Message":"Access denied."}
500 Internal server error {"Code":500,"Message":"Unexpected server error."}

Use Aspose.Cells Cloud SDKs

Using an SDK is the fastest way to develop. An SDK handles low‑level details so you can focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to call Aspose.Cells web services using various SDKs:

Add a Digital Signature to an Excel Workbook Decrypt an Excel Workbook