ЯсноДок
PDF API
API для интеграций

PDF API для сайта, CRM и внутренних сервисов

Подключите обработку PDF по API-ключу: сжатие, объединение, разделение, защита, водяные знаки, метаданные и конвертации документов. Подходит для повторных задач, кабинетов клиентов и автоматизации документооборота.

API-ключ Месячные лимиты JSON-ответ Временные файлы
Быстрый старт

Один ключ для PDF-инструментов

API работает поверх тех же обработчиков, что и веб-инструменты ЯсноДок. Для PDF в Word и OCR используйте conversion endpoints, для merge/split/compress - PDF jobs с отдельной ссылкой на скачивание. 

curl -X POST https://yasnodoc.ru/api/v1/conversions/pdf-to-word \
  -H "Authorization: Bearer $YASNODOC_PDF_API_KEY" \
  -H "Idempotency-Key: order-123-pdf-word" \
  -F "file=@scan.pdf" \
  -F "mode=auto" \
  -F "layoutMode=layout" \
  -F "searchablePdf=1"
Запросить доступ JSON-каталог

Как устроена авторизация

Для API-доступа используется заголовок Authorization: Bearer <ключ> или X-API-Key. Ключ привязан к клиенту и месячному лимиту запусков.

Как получить результат

PDF в Word/OCR возвращает объект conversion. Merge, split и compress возвращают объект operation. Генераторы документов возвращают document со ссылками на PDF, DOCX или ZIP. Скачивание результата выполняется с тем же Authorization или X-API-Key.

Как считаются лимиты

Каждый API-запуск учитывается по клиенту, месяцу и инструменту. Текущий расход доступен через GET /api/v1/account/usage или GET /api/pdf-api/status с тем же API-ключом.

Как повторять запросы

Для POST-запросов передавайте Idempotency-Key. Если клиент повторит тот же запрос, API вернёт сохранённый ответ без второго списания лимита.

Инструменты API

Что можно подключить

Большинство запросов принимают multipart/form-data. Для PDF в Word доступны режимы авто, текстовый PDF, скан и сохранение структуры.

JSON-каталог

Список endpoint, методов и страниц.

PDF в Word API

DOCX, сканы, таблицы и PDF с поиском.

OCR PDF API

Отдельный endpoint для сканов и searchable PDF.

Счет API

JSON на входе, PDF и DOCX на выходе.

КП API

Коммерческое предложение PDF и DOCX из JSON: клиент, позиции, условия.

Накладная API

Товарная накладная ТОРГ-12 из JSON: поставщик, покупатель, товары, НДС и подписи.

Пакет документов API

Счет + акт, ТОРГ-12 или УПД в ZIP, можно добавить проверку реквизитов или контрагента.

Сжать PDF

Оптимизация размера файла.

Восстановить PDF

Repair PDF через пересборку файла.

Объединить PDF

Склейка нескольких файлов.

Разделить PDF

Извлечение страниц и ZIP.

Порядок страниц

Перестановка страниц PDF.

Закрасить PDF

Скрытие фрагментов на страницах.

Защитить PDF

Пароль на открытие файла.

Метаданные PDF

Очистка или запись свойств.

Word в PDF

Конвертация DOC/DOCX.

PDF в PowerPoint

Страницы PDF как слайды PPTX.

PDF в JPG/PNG

Страницы PDF как изображения.
PDF в Word v1

Endpoint конвертации

POST /api/v1/conversions/pdf-to-word
POST /api/v1/pdf/ocr
POST /api/v1/pdf/merge
POST /api/v1/pdf/split
POST /api/v1/pdf/compress
POST /api/v1/documents/invoices
POST /api/v1/documents/proposals
POST /api/v1/documents/acceptance-acts
POST /api/v1/documents/waybills
POST /api/v1/documents/upd
POST /api/v1/documents/vat-invoices
POST /api/v1/documents/power-m2
POST /api/v1/documents/closing-package
POST /api/v1/documents/closing-package-requisites
POST /api/v1/documents/closing-package-counterparty
GET  /api/v1/conversions/{id}
GET  /api/v1/conversions/{id}/download?format=docx
GET  /api/v1/conversions/{id}/download?format=searchable_pdf
GET  /api/v1/pdf/jobs/{id}
GET  /api/v1/pdf/jobs/{id}/download
GET  /api/v1/documents/{id}
GET  /api/v1/documents/{id}/download?format=pdf|docx|zip
GET  /api/v1/account/usage
GET  /api/v1/account/limits

Для сложных сканов и таблиц можно передать enhancedRecognition=1: сервис применит усиленное распознавание структуры, строк и колонок.

Короткие ответы

PDF API - это отдельная оплата?

Да. API рассчитан на пакетный или подписочный доступ по ключу, а не на разовую оплату через форму сайта.

Можно встроить PDF API в CRM?

Да. Запросы идут с сервера через HTTPS, результат приходит JSON-ответом с временной ссылкой на файл.

Нужно ли хранить файлы у себя?

Можно скачать результат сразу после обработки. На стороне ЯсноДок файлы остаются только во временном хранилище.

Какие лимиты доступны?

Лимит задается для каждого API-ключа. Базовое серверное значение - 1000 запусков в месяц, его можно менять.