Добавление водяного знака в файлы Excel – Документация Aspose.Cells Cloud

Этот REST API добавляет водяной знак в файлы Excel.

Необходимые условия: Вы должны получить действительный JWT-токен доступа и убедиться, что файл Excel находится в поддерживаемом формате (например, .xlsx, .xls).
Описание: Водяной знак — это полупрозрачное текстовое наложение, применяемое к каждому листу для указания права собственности или конфиденциальности.

API PostWatermark

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

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.

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

Имя параметра Тип Расположение Описание
file file formData (multipart body) Файл Excel, к которому будет применён водяной знак.
text string query Текст водяного знака для отображения.
color string query Цвет водяного знака в формате ARGB в шестнадцатеричном виде (например, 004433ff).

Ответ

JSON-ответ содержит массив Files. Для каждого объекта файла:

  • Filename – имя обработанной рабочей книги.
  • FileSize – размер файла в байтах.
  • FileContent – содержимое файла Excel с водяным знаком, закодированное в Base64; для получения фактического файла его нужно декодировать.
{
    "Status" : "OK",
    "Code" : 200,
    "Files": [
        {
            "Filename" : "[имя файла1]",
            "Filesize" : [размер файла],
            "FileContent" : "[Base64String]"
        },        {
            "Filename" : "[имя файла2]",
            "Filesize" : [размер файла],
            "FileContent" : "[Base64String]"
        },        {
            "Filename" : "[имя файла3]",
            "Filesize" : [размер файла],
            "FileContent" : "[Base64String]"
        }
    ]
}

Коды HTTP-статуса

Код Значение Описание
200 OK Водяной знак успешно применён; ответ содержит детали операции.
400 Bad Request Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла).
401 Unauthorized Недействительный или отсутствующий JWT-токен.
413 Payload Too Large Загруженный файл превышает ограничение по размеру.
500 Internal Server Error Непредвиденная ошибка сервера.

Как использовать API PostWatermark с SDK

Спецификация API PostWatermark

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

Вы можете использовать утилиту командной строки cURL для вызова веб-сервисов Aspose.Cells. Пример ниже показывает полный запрос, включая обязательный заголовок аутентификации. Замените <your‑jwt‑token> на действительный JWT-токен доступа, полученный из точки аутентификации Aspose.

Использование SDK Aspose.Cells Cloud

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

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

Добавление фонового изображения в рабочую книгу