Documentation –

Developer-Guide: Добавление водяного знака в файлы Excel

Mon, 01 Jan 0001 00:00:00 +0000

Этот 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.

Запрос

curl -v "https://api.aspose.cloud/v3.0/cells/watermark?text=aspose.cells.cloud&color=004433ff" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <your-jwt-token>" \
  -F "file=@Sample.xlsx"

Ответ

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

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

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

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

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

Mon, 01 Jan 0001 00:00:00 +0000

REST API

Этот REST API добавляет фоновое изображение в рабочую книгу Excel.

POST https://api.aspose.cloud/v3.0/cells/{name}/background

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

API Aspose.Cells Cloud являются защищёнными и требуют аутентификации на основе JWT-токена.

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

Имя параметра	Тип	Описание
`picPath`	string	Путь к файлу изображения, используемому в качестве фона.
`folder`	string	Папка, содержащая исходную рабочую книгу.
`storageName`	string	Имя хранилища, в котором находится файл.

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

Имя параметра	Тип	Описание
`datafile`	file	Файл рабочей книги, к которой будет применено фоновое изображение.

Параметр пути – {name} в URL-адресе представляет имя файла рабочей книги (например, Book1.xlsx).

Ответ

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

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

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

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

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

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

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

Запрос

curl -X PUT "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/background?picPath=DotnetFiles%2FWaterMark.png&folder=DotnetFiles" \
     -H "Authorization: Bearer <access_token>" \
     -H "accept: multipart/form-data" \
     -H "Content-Type: multipart/form-data" \
     -F "datafile=@/path/to/Book1.xlsx"

Ответ

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

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

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

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

Developer-Guide: Удаление фонового изображения из книги Excel

Mon, 01 Jan 0001 00:00:00 +0000

Этот REST API удаляет фоновое изображение книги Excel.

API DeleteWorkbookBackground

DELETE https://api.aspose.cloud/v3.0/cells/{name}/background

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

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

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

Имя параметра	Тип	Описание	Обязательный
folder	string	Папка, содержащая исходную книгу.	Нет
storageName	string	Имя используемого сервиса хранилища.	Нет

Ответ

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

HTTP-коды состояния

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

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

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

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

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Приведённый ниже пример демонстрирует полный DELETE-запрос с необходимым заголовком аутентификации; тело запроса не требуется.

Запрос

curl -X DELETE "https://api.aspose.cloud/v3.0/cells/{name}/background?folder=DotnetFiles" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>" \
     -H "x-aspose-client: Containerize.Swagger"

Ответ

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

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

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

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