Блокировка файлов Excel – Документация API Aspose.Cells Cloud

Версия API: v3.0 (текущая)

Этот REST API блокирует рабочие тетради Excel.

API PostLock

POST https://api.aspose.cloud/v3.0/cells/lock

Необходимые условия – Запрос должен отправляться по протоколу HTTPS и включать действительный токен OAuth 2.0 Bearer в заголовке Authorization.

Параметры запроса:

Имя параметра	Тип	Расположение	Описание
file	file	form‑data (multipart body)	Рабочая тетрадь Excel, подлежащая загрузке и блокировке.
password	string	query string	Пароль для рабочей тетради (необязательно).

Спецификация OpenAPI определяет публично доступное программное интерфейсное решение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как вызвать облачный API с помощью cURL.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

Ответ

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Вы можете загрузить тестовую рабочую тетрадь — Sample.xlsx — для проверки запроса.

Примечание: API поддерживает файлы размером до 100 МБ; более крупные данные могут привести к ответу с кодом 413 («Payload Too Large» — «Слишком большой объем данных»).

Детали ответа

Поле	Тип	Описание
Filename	string	Имя заблокированной рабочей тетради, возвращаемое сервисом.
FileSize	integer	Размер заблокированного файла в байтах.
FileContent	string (Base64)	Заблокированная рабочая тетрадь, закодированная в формате Base64.

Для извлечения заблокированной рабочей тетради декодируйте значение FileContent из Base64 и сохраните его, используя имя файла Filename, указанное в ответе.

Обработка ошибок

– API возвращает стандартные HTTP-коды состояния (например, 400 Bad Request, 401 Unauthorized, 500 Internal Server Error) вместе с объектом ошибки в формате JSON, содержащим поля Code и Message.

Семейство облачных SDK

Использование SDK — это лучший способ ускорить разработку. SDK скрывает низкоуровневые детали, позволяя сосредоточиться на задачах вашего проекта. Ознакомьтесь со репозиторием на GitHub, чтобы получить полный список SDK Aspose.Cells Cloud.

Следующие примеры кода демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK:

Снять защиту с книги Excel — Aspose.Cells Cloud API Изменение пароля защиты рабочей книги Excel