Add a Digital Signature to an Excel Workbook – Aspose.Cells Cloud API

Prerequisites:
Before calling this endpoint, ensure you have:

A valid JWT access token obtained via Aspose Cloud authentication.
The target workbook uploaded to your Aspose Cloud storage.
A digital signature file in .pfx or .p12 format and its password.

This REST API adds a digital signature to an Excel workbook.

PostDigitalSignature API

POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature

Security and Authentication

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

Request Parameters

Parameter Name	Type	Location	Description
name	string	`<code>path</code>`	The name of the workbook.
digitalsignaturefile	string	`<code>query</code>`	Path to the digital‑signature file (`.pfx` or `.p12`).
password	string	`<code>query</code>`	Password for the workbook, if it is protected.
folder	string	`<code>query</code>`	Folder where the workbook is stored.
storageName	string	`<code>query</code>`	Name of the storage service to use.

Note: If the file name contains special characters, URL‑encode it before adding it to the query string.

Error Handling

HTTP Status	Meaning
200	Signature applied successfully.
400	Bad request – missing or invalid parameters.
401	Unauthorized – invalid or expired OAuth token.
403	Forbidden – insufficient permissions or access denied.
500	Internal server error – unexpected failure.

Https status Error Responses

HTTP Status	Code	Description
400	BadRequest	Missing or invalid parameters.
401	Unauthorized	Invalid or missing access token.
404	NotFound	Specified workbook not found in the given folder/storage.
500	InternalServerError	Unexpected server error.

How to Use the PostDigitalSignature API with SDKs

PostDigitalSignature API Specification

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

You can use the cURL command‑line tool to call Aspose.Cells web services. The example below demonstrates a request to the API:

Request

curl -v "https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature?digitalsignaturefile=signature.pfx&password=YourPassword" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

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

Response Schema
The API returns a JSON object with the following fields:

Field	Type	Description
`Code`	int	HTTP‑like status code indicating the result.
`Status`	string	Short text describing the outcome (e.g., `OK`).
`SignatureId`	string	Identifier of the applied digital signature (optional).
`Message`	string	Additional information or error details (optional).

Use Aspose.Cells Cloud SDKs

Using an SDK simplifies integration and reduces boiler‑plate code. 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:

Protect an Excel Workbook with Aspose.Cells Cloud API Protect Excel Files