为 Excel 工作簿添加数字签名 – Aspose.Cells Cloud API

前置条件：
调用此端点前，请确保您已完成以下准备：

已通过 Aspose Cloud 身份验证获取有效的 JWT 访问令牌。
已将目标工作簿上传至您的 Aspose Cloud 存储空间。
拥有 .pfx 或 .p12 格式的数字签名文件及其密码。

此 REST API 可为 Excel 工作簿添加数字签名。

PostDigitalSignature API

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

安全与身份验证

Aspose.Cells Cloud API 具备安全性，需采用基于 JWT 令牌的身份验证。

请求参数

参数名	类型	位置	描述
name	string	`<code>path</code>`	工作簿的文件名。
digitalsignaturefile	string	`<code>query</code>`	数字签名文件（`.pfx` 或 `.p12`）的路径。
password	string	`<code>query</code>`	工作簿密码（若工作簿受保护）。
folder	string	`<code>query</code>`	工作簿所在的文件夹。
storageName	string	`<code>query</code>`	要使用的存储服务名称。

注意：若文件名包含特殊字符，请先对其进行 URL 编码后再添加至查询字符串中。

错误处理

HTTP 状态码	含义
200	签名添加成功。
400	请求错误 — 参数缺失或无效。
401	未授权 — OAuth 令牌无效或已过期。
403	禁止访问 — 权限不足或被拒绝访问。
500	服务器内部错误 — 发生意外故障。

HTTP 状态码错误响应

HTTP 状态码	错误码	描述
400	BadRequest	参数缺失或无效。
401	Unauthorized	令牌无效或缺失。
404	NotFound	在指定文件夹/存储中未找到指定的工作簿。
500	InternalServerError	服务器发生意外错误。

如何结合 SDK 使用 PostDigitalSignature API

PostDigitalSignature API 规范

OpenAPI 规范定义了一个公开可访问的编程接口，允许您直接通过网页浏览器执行 REST 交互。

您可使用 cURL 命令行工具调用 Aspose.Cells 网络服务。以下示例演示了如何向该 API 发起请求：

请求

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>"

响应

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

响应模式
API 返回一个 JSON 对象，包含以下字段：

字段	类型	描述
`Code`	int	表示结果的类 HTTP 状态码。
`Status`	string	描述结果的简短文本（例如 `OK`）。
`SignatureId`	string	已添加数字签名的标识符（可选）。
`Message`	string	附加信息或错误详情（可选）。

使用 Aspose.Cells Cloud SDK

使用 SDK 可简化集成过程并减少样板代码。请查阅 GitHub 仓库获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用多种 SDK 调用 Aspose.Cells 网络服务：

使用 Aspose.Cells Cloud API 保护 Excel 工作簿保护 Excel 文件