Операции · Подпись и защита

Скрыть персональные данные

Скрывает персональные данные: находит их сама (find) и/или берёт области (areas) и удаляет из файла — под чёрными прямоугольниками текста и пикселей больше нет. Ничего не нашлось и областей нет — ошибка без списания.

Запрос: POST /v1/pdf/redact
Инструмент MCP: redact_pdf
Вход: PDF с текстовым слоем (скан — сначала OCR или areas)
Результат: PDF
Единица цены: 10 МБ — как считается

Параметры

Тело запроса — JSON. Лишние поля API игнорирует.

Параметр	Тип	Описание
`file_id`обязательный	`string`	file_id загруженного файла (POST /v1/upload); действует час.
`areas`	`object[]`	Области вручную: [{"page": 1, "box": [x0, y0, x1, y1]}] долями видимой страницы — например, boxes из find-personal-data. До 5000.По умолчанию: `[]`
`find`	`object \| null`	Найти и скрыть тем же запросом: {"kinds": [...], "words": [...]} — как у find-personal-data. Нужно areas, find или оба.
`clean`	`boolean`	Убрать скрытые данные файла: автора и свойства, XMP, комментарии, вложения, скрипты, миниатюры.По умолчанию: `true`
`webhook_url`	`string`	https-адрес: по завершении SmartPDF отправит на него POST с результатом и подписью — вместо опроса статуса (раздел «Вебхуки»).

Запрос

Это шаг 2 полного цикла: файл уже загружен, а статус и скачивание — как в быстром старте. Функция call и переменные — оттуда же.

POST /v1/pdf/redact

BODY=$(jq -n --arg file_id "$FILE_ID" '{file_id: $file_id, find: { kinds: ["phone", "email", "snils", "inn"], words: ["Иванов Иван Иванович"] }}')
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/redact

Ответ

202 Accepted — операция оплачена и поставлена в очередь. Дальше — опрос GET /v1/tasks/{task_id} или вебхук.

202 Accepted

{
  "task_id": "3f2c5b0e-8a41-4d7e-9c1f-5d0b8f2e7a64"
}

Эта страница для агентов: Markdown · llms.txt