Водяной знак
Добро пожаловать в документацию Watermark API — упрощённое решение, позволяющее встраивать пользовательский текст водяного знака напрямую в широкий спектр форматов электронных таблиц одним запросом, удобным для разработчиков. Независимо от того, работаете ли вы с файлами Microsoft Excel (.xlsx, .xls, .xlsm), классическими CSV и TSV, Apple Numbers (.numbers) или многими другими поддерживаемыми типами, наш API выполнит всю тяжёлую работу за вас. Просто загрузите исходный файл, укажите желаемый текст водяного знака, и наш безопасный, высокопроизводительный сервис вернёт версию с водяным знаком, готовую к распространению. Эта возможность идеально подходит для добавления логотипов бренда, идентификаторов версий, уведомлений о конфиденциальности или любого пользовательского ярлыка, усиливающего контроль над документами и их подлинность во всей организации.
Основные функции
Разработанный с упором на скорость и безопасность, Watermark API бесшовно интегрируется в любой существующий рабочий процесс, будь то построение облачной SaaS‑платформы, внутреннего инструмента управления файлами или автоматизированного конвейера отчётности. Конечная точка принимает multipart‑загрузки, проверяет целостность файлов и точно накладывает водяной знак, сохраняя исходную структуру данных неизменной, при этом добавленный текст остаётся чётко видимым. Поскольку API ориентирован на разработчиков, в руководстве вы найдёте понятные сообщения об ошибках, полные коды ответов и подробные примеры запросов. Погрузитесь, чтобы узнать, как один вызов API может защитить ваши электронные таблицы, повысить согласованность бренда и упростить управление жизненным циклом документов.
Документы
Параметры
- AppRequest.WatermarkText: Если вы хотите использовать RGB‑заполнение цвета, используйте этот ввод; иначе используйте HEX‑цвет.
- AppRequest.WatermarkColorHex: Если вы хотите использовать RGB‑заполнение цвета, используйте этот ввод; иначе используйте HEX‑цвет.
- AppRequest.WatermarkTextRGB: Если вы хотите использовать RGB‑заполнение цвета, используйте этот ввод; иначе используйте HEX‑цвет.
- UploadFileRequest.OperationId: Это идентификатор операции
- UploadFileRequest.Files: Это файлы, которые необходимо загрузить в наш онлайн‑сервис; вы можете подготовить данные любым способом, но они должны соответствовать стандарту HTML‑элемента input type="file".
-
Отправьте запрос, включающий файлы и токен доступа Watermark API
curl -X 'POST' \ 'https://api.sheetize.cloud/watermark' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.WatermarkText=TheWatermarkText' \ -F 'AppRequest.WatermarkColorHex=ff0000' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Сервис ответит URL‑адресом для загрузки обработанного файла; в этом примере он выглядит так:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
Отправьте запрос, включающий имя файла и имя папки для Download API
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Вы получите файл и сможете либо использовать его, либо просто передать на следующий этап вашего рабочего процесса.
