Подписать PDF
Ставит на страницу визуальную подпись — текст или изображение. Это не электронная подпись (ЭП).
- Запрос
POST /v1/pdf/sign- Инструмент MCP
sign_pdf- Вход
- Результат
- Единица цены
- 10 МБ — как считается
Параметры
Тело запроса — JSON. Лишние поля API игнорирует.
| Параметр | Тип | Описание |
|---|---|---|
file_idобязательный | string | file_id загруженного файла (POST /v1/upload); действует час. |
signature_dataобязательный | string | Текст подписи или изображение data:image/png|jpeg|webp;base64,… до 2 МБ. |
page | integer | Номер страницы с 1.По умолчанию: 1 |
x | number | Левый край блока — доля ширины страницы от левого края: от 0 до 1.По умолчанию: 0.1 |
y | number | Верхний край блока — доля высоты страницы от верхнего края: от 0 до 1.По умолчанию: 0.85 |
width | number | Ширина блока — доля ширины страницы: больше 0, до 1.По умолчанию: 0.2 |
height | number | Высота блока — доля высоты страницы: больше 0, до 1.По умолчанию: 0.05 |
webhook_url | string | https-адрес: по завершении SmartPDF отправит на него POST с результатом и подписью — вместо опроса статуса (раздел «Вебхуки»). |
Запрос
Это шаг 2 полного цикла: файл уже загружен, а статус и скачивание — как в быстром старте. Функция call и переменные — оттуда же.
BODY=$(jq -n --arg file_id "$FILE_ID" '{file_id: $file_id, signature_data: "Иванов И. И.", page: 1, x: 0.6, y: 0.85}')
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/signОтвет
202 Accepted — операция оплачена и поставлена в очередь. Дальше — опрос GET /v1/tasks/{task_id} или вебхук.
{
"task_id": "3f2c5b0e-8a41-4d7e-9c1f-5d0b8f2e7a64"
}