Добавление цифровой подписи в рабочую книгу Excel – Aspose.Cells Cloud API
Необходимые условия:
Перед вызовом данной конечной точки убедитесь, что у вас имеются:
- Действующий JWT-токен доступа, полученный в результате аутентификации в Aspose Cloud.
- Целевая рабочая книга, загруженная в ваше облачное хранилище Aspose Cloud.
- Файл цифровой подписи в формате
.pfxили.p12, а также его пароль.
Данный REST API добавляет цифровую подпись к рабочей книге Excel.
API PostDigitalSignature
POST https://api.aspose.cloud/v4.0/cells/{name}/digitalsignature
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе 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 | Непредвиденная ошибка сервера. |
Как использовать API PostDigitalSignature с SDK
Спецификация API PostDigitalSignature
OpenAPI-спецификация определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для вызова веб-сервисов Aspose.Cells. Пример ниже демонстрирует запрос к API:
Схема ответа
API возвращает JSON-объект со следующими полями:
| Поле | Тип | Описание |
|---|---|---|
Code |
int | Код HTTP-подобного статуса, указывающий результат. |
Status |
string | Краткое текстовое описание результата (например, OK). |
SignatureId |
string | Идентификатор применённой цифровой подписи (опционально). |
Message |
string | Дополнительная информация или детали ошибки (опционально). |
Использование SDK Aspose.Cells Cloud
Использование SDK упрощает интеграцию и снижает объём шаблонного кода. Ознакомьтесь с репозиторием на GitHub, чтобы получить полный список SDK Aspose.Cells Cloud.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: