Водяной знак
Наносит водяной знак — текст или логотип. Нужен ровно один из параметров text и image_file_id.
- Запрос
POST /v1/pdf/watermark- Инструмент MCP
watermark_pdf- Вход
- PDF; логотип — PNG, JPG или WEBP через POST /v1/upload
- Результат
- Единица цены
- 10 МБ — как считается
Параметры
Тело запроса — JSON. Лишние поля API игнорирует.
| Параметр | Тип | Описание |
|---|---|---|
file_idобязательный | string | file_id загруженного файла (POST /v1/upload); действует час. |
text | string | Текст знака (кириллица поддерживается). |
image_file_id | string | file_id загруженного логотипа вместо текста. Прозрачность PNG сохраняется. |
font_size | integer | Размер шрифта текста: от 8 до 200.По умолчанию: 48 |
color | string | Цвет текста — hex, например #0F766E.По умолчанию: "#FF0000" |
opacity | number | Непрозрачность: от 0 до 1.По умолчанию: 0.3 |
angle | number | Угол наклона в градусах: от −180 до 180.По умолчанию: 45 |
position | string | center — в центре; tile — плиткой по всей странице; углы — в выбранном углу.Значения: "center", "tile", "top-left", "top-right", "bottom-left", "bottom-right"По умолчанию: "center" |
pages | integer[] | "all" | Номера страниц с 1 или "all".По умолчанию: "all" |
scale | number | Ширина логотипа — доля ширины страницы: от 0,1 до 2; высота — по пропорциям.По умолчанию: 0.3 |
webhook_url | string | https-адрес: по завершении SmartPDF отправит на него POST с результатом и подписью — вместо опроса статуса (раздел «Вебхуки»). |
Запрос
Это шаг 2 полного цикла: файл уже загружен, а статус и скачивание — как в быстром старте. Функция call и переменные — оттуда же.
BODY=$(jq -n --arg file_id "$FILE_ID" '{file_id: $file_id, text: "КОПИЯ", opacity: 0.2, position: "tile"}')
curl -sS --fail-with-body -H "X-API-Key: $SMARTPDF_API_KEY" -H "Content-Type: application/json" \
-d "$BODY" https://api.smartpdf.ru/v1/pdf/watermarkОтвет
202 Accepted — операция оплачена и поставлена в очередь. Дальше — опрос GET /v1/tasks/{task_id} или вебхук.
{
"task_id": "3f2c5b0e-8a41-4d7e-9c1f-5d0b8f2e7a64"
}