Защита файлов Excel
Этот REST API защищает файлы Excel.
REST API
POST http://api.aspose.cloud/v3.0/cells/protect
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Местоположение | Описание |
|---|---|---|---|
| file | file | formData (тело) | Загружаемый файл |
| password | string | строка запроса (password) |
Пароль, используемый для защиты рабочей книги |
Ответ
{
"Status":"OK",
"Code":200,
"Files": [
{
"Filename": "защищённое имя файла: smaple1.xlsx",
"FileSize": размер,
"FileContent": "-----Base64-строка sample1-----"
},
{
"Filename": "защищённое имя файла: sample2.xlsx",
"FileSize": размер,
"FileContent": "-----Base64-строка sample2-----"
}
]
}
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (ОК) | Фильтр успешно применён; ответ содержит детали операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизован) | Неверный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой полезный груз) | Загруженный файл превышает ограничение по размеру. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PostProtect с SDK
Спецификация API PostProtect
OpenAPI-спецификация определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как вызвать облачный API с помощью cURL.
Обработка ошибок
– API может возвращать следующие коды состояния:
| HTTP-код | Значение | Пример JSON-сообщения об ошибке |
|---|---|---|
| 400 | Неверный запрос (например, отсутствует файл) | {"Code":400,"Message":"Файл обязателен."} |
| 401 | Неавторизован (неверный или отсутствующий токен) | {"Code":401,"Message":"Неверный токен доступа."} |
| 403 | Запрещено (недостаточно прав) | {"Code":403,"Message":"Доступ запрещён."} |
| 500 | Внутренняя ошибка сервера | {"Code":500,"Message":"Непредвиденная ошибка сервера."} |
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ разработки. SDK берёт на себя работу с низкоуровневыми деталями, позволяя вам сосредоточиться на задачах вашего проекта. Полный список SDK Aspose.Cells Cloud доступен на GitHub-репозитории.
Следующие примеры кода демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK: