REST API

Конвертер документов с API

Конвертируйте Word, Excel, PowerPoint и изображения в PDF, а PDF — в Word одним HTTP-запросом из 1С, CRM, бэкенда или скрипта. Ключ создаётся в личном кабинете за минуту, лимиты — те же, что у аккаунта на сайте.

Получить API-ключ Быстрый старт

11 конвертацийофисные форматы, PDF и изображения

5 в деньбесплатно, дальше — операции тарифа

до 25 МБна файл, результат хранится 24 часа

Кому подходит

API для конвертации документов в ваших системах

Интеграторы 1С

Обработка или расширение отправляет HTTP-запрос и получает готовый PDF счёта, акта или договора — без установки офисного пакета на сервер 1С.

CRM и ERP

Сохраняйте коммерческие предложения и выгрузки в PDF прямо из карточки сделки, а входящие PDF превращайте в редактируемый DOCX.

SaaS-сервисы

Добавьте в свой продукт экспорт в PDF и импорт Word-документов, не поддерживая LibreOffice и очереди конвертации у себя.

Автоматизация бэк-офиса

Скрипты и планировщики: пакетная конвертация архивов, отчёты Excel в PDF по расписанию, подготовка документов для ЭДО и банка.

Боты и no-code

Любая платформа, которая умеет отправлять multipart-запрос с заголовком Authorization, может конвертировать файлы через API.

ИИ-агенты

Для Claude, Cursor и других ассистентов есть MCP-сервер с теми же инструментами — агенту не нужно писать HTTP-код.

Форматы

Что конвертирует API

Каждой конвертации соответствует slug — его вы передаёте в поле tool. Актуальный список с допустимыми расширениями всегда доступен в GET /api/v1/tools.

Результат — один файл: PDF, DOCX или DOC. Качество то же, что на сайте: проверьте его на своём документе на странице нужного инструмента, прежде чем подключать интеграцию.

tool	Конвертация	Файлы
`word-v-pdf`	Word в PDF	.docx
`excel-v-pdf`	Excel в PDF	.xlsx, .xls
`powerpoint-v-pdf`	PowerPoint в PDF	.ppt, .pptx
`jpg-v-pdf`	JPG в PDF	.jpg, .jpeg, .png
`xls-v-pdf`	XLS в PDF	.xls
`csv-v-pdf`	CSV в PDF	.csv
`pdf-v-word`	PDF в Word	.pdf
`doc-v-docx`	DOC в DOCX	.doc
`docx-v-doc`	DOCX в DOC	.docx
`rtf-v-docx`	RTF в DOCX	.rtf
`odt-v-docx`	ODT в DOCX	.odt

Как это работает

Четыре шага от файла до результата

1Создайте ключ в личном кабинете → «API и интеграции» и передавайте его в заголовке Authorization: Bearer
2Отправьте файл и slug инструмента в POST /api/v1/conversions — в ответ придёт id задачи
3Опрашивайте GET /api/v1/conversions/{id} раз в 2–3 секунды, пока статус не станет succeeded
4Скачайте результат по подписанной ссылке downloadUrl — она действует 1 час и не требует ключа

Методы

REST API v1

Метод	Что делает
`GET /api/v1/me`	Email, тариф, остаток бесплатных и разовых операций.
`GET /api/v1/tools`	Список конвертаций: slug, название, расширения, максимальный размер.
`POST /api/v1/conversions`	Отправить файл (multipart: tool, file). Ответ 202 с id задачи.
`GET /api/v1/conversions/{id}`	Статус: queued, processing, succeeded, failed или expired и ссылка downloadUrl.
`GET /api/v1/conversions/{id}/download`	Сам файл — с ключом или по подписанной ссылке downloadUrl.

Ответы — JSON, ошибки — в формате {"error": {"code", "message"}} с сообщением на русском. CORS разрешён.

Быстрый старт

Первая конвертация за пять минут

Замените dfk_ваш_ключ на свой ключ или задайте переменную окружения DOKFORMAT_KEY.

# 1. Отправить файл на конвертацию
curl -X POST https://dokformat.ru/api/v1/conversions \
  -H "Authorization: Bearer dfk_ваш_ключ" \
  -F tool=word-v-pdf \
  -F file=@Договор.docx
# → {"id":"…","status":"queued"}

# 2. Проверять статус, пока status не станет succeeded
curl https://dokformat.ru/api/v1/conversions/<id> -H "Authorization: Bearer dfk_ваш_ключ"

# 3. Скачать результат
curl -OJ https://dokformat.ru/api/v1/conversions/<id>/download -H "Authorization: Bearer dfk_ваш_ключ"

Ответ со статусом

Когда status становится succeeded, в ответе появляются имя, размер результата и downloadUrl. При ошибке конвертации статус — failed, а причина — в поле error.

{
  "id": "4f1c2a9e-8b7d-4c3e-9a51-2d6f0b8e7c10",
  "status": "succeeded",
  "tool": "word-v-pdf",
  "inputName": "Договор.docx",
  "outputName": "Договор.pdf",
  "outputSize": 182345,
  "error": null,
  "createdAt": "2026-10-04T09:15:02.000Z",
  "downloadUrl": "https://dokformat.ru/api/v1/conversions/4f1c2a9e-…/download?expires=…&signature=…"
}

Остаток лимитов

curl https://dokformat.ru/api/v1/me -H "Authorization: Bearer dfk_ваш_ключ"

{
  "email": "you@example.ru",
  "plan": {
    "name": "Лайт на месяц",
    "limit": 500,
    "used": 37,
    "expiresAt": "2026-11-04T09:00:00.000Z"
  },
  "free": {
    "used": 2,
    "limit": 5
  },
  "credits": 0
}

Ошибки

Коды ошибок API

code	HTTP	Когда
`UNAUTHORIZED`	401	Нет ключа, ключ неверный или отозван.
`RATE_LIMITED`	429	Больше 60 запросов в минуту на ключ. Подождите столько секунд, сколько указано в Retry-After.
`INVALID_REQUEST`	400	Тело запроса не multipart/form-data.
`UNKNOWN_TOOL`	400	Неизвестный slug инструмента — список в GET /api/v1/tools.
`INVALID_FILE_TYPE`	400	Расширение файла не подходит инструменту.
`FILES_REQUIRED`	400	В запросе нет поля file или файл пустой.
`FILE_TOO_LARGE`	413	Файл больше 25 МБ.
`FREE_LIMIT`	402	Бесплатные операции на сегодня закончились, тарифа нет.
`PAID_LIMIT`	402	Исчерпан лимит операций тарифа.
`NOT_FOUND`	404	Конвертации нет или она принадлежит другому аккаунту.
`NOT_READY`	409	Результат ещё не готов — проверьте статус.
`EXPIRED`	410	Результат удалён: файлы хранятся 24 часа.
`CONVERT_FAILED`	502	Не удалось запустить конвертацию — повторите запрос позже.

Лимиты

Лимиты — те же, что у аккаунта

API, MCP-сервер, Telegram-бот и расширение расходуют одни и те же операции: 5 бесплатных серверных конвертаций в день (сброс в 00:00 МСК), затем — операции тарифа или купленные разовые операции. Неудачные конвертации лимит не расходуют.

Технические ограничения: до 25 МБ на файл и 60 запросов в минуту на ключ.

Нужен договор, оплата по счёту или объём больше тарифов — корпоративная версия или коробочная версия для ваших серверов.

Тарифы

Сколько стоит

Тариф	Операции	Цена
Бесплатно	5 в день	0 ₽
Одна операция	1 операция	59 ₽
Доступ на сутки	до 100 за сутки	99 ₽
Лайт на месяц	до 500 в месяц	249 ₽
Годовой доступ	до 500 в месяц	1 990 ₽

Отдельной платы за API нет. Тариф покупается на странице тарифов и сразу действует для сайта, API, MCP и бота. Автопродления нет.

Безопасность

Ключи, хранение файлов и доступ

Ключ хранится только у васВ базе — лишь SHA-256-хэш ключа; полный ключ показывается один раз при создании. До 10 активных ключей на аккаунт.
Отзыв в один кликОтозванный ключ перестаёт работать сразу. Для каждой интеграции удобно завести отдельный ключ.
Хранение 24 часаИсходный файл удаляется сразу после обработки, результат — через 24 часа, как и на сайте.
Подписанные ссылкиdownloadUrl действует 1 час и открывает только один результат — ключ не попадает в ссылки и логи.
Ограничение частоты60 запросов в минуту на ключ защищают аккаунт от случайных циклов и утечек.
Доступ только к своим задачамСтатус и результат конвертации видит только аккаунт, который её создал.

Другие способы подключения

Тот же аккаунт и те же лимиты

Вопросы и ответы

Частые вопросы об API

Сколько стоит API для конвертации документов?

Отдельной платы за API нет. Каждая конвертация через API, MCP-сервер, Telegram-бот или расширение расходует одну операцию из лимитов аккаунта: 5 бесплатных в день или операции платного тарифа — от 59 ₽ за разовую операцию до 1 990 ₽ за год.

Как получить API-ключ?

Войдите в личный кабинет по коду на email (пароль не нужен) и откройте раздел «API и интеграции». Ключ начинается с dfk_ и показывается один раз — сохраните его в переменных окружения или менеджере секретов.

Почему API асинхронный?

Конвертация больших документов может занимать десятки секунд. Поэтому POST /api/v1/conversions сразу возвращает id задачи, а результат вы забираете, когда статус станет succeeded. Опрашивайте статус раз в 2–3 секунды.

Какие форматы поддерживает API?

Серверные конвертации ДокФормата: Word в PDF, Excel в PDF, PowerPoint в PDF, JPG в PDF, XLS в PDF, CSV в PDF, PDF в Word, DOC в DOCX, DOCX в DOC, RTF в DOCX, ODT в DOCX. Объединение, сжатие и разделение PDF работают в браузере и через API пока недоступны.

Какой максимальный размер файла?

25 МБ на файл. Неудачные конвертации лимит операций не расходуют.

Сколько хранятся результаты?

24 часа, как и на сайте. Исходный файл удаляется сразу после обработки. Скачайте результат и сохраните у себя, если он нужен дольше.

Можно ли вызывать API из браузера?

Технически да — CORS разрешён. Но не размещайте ключ в клиентском коде сайта: любой посетитель сможет тратить ваши операции. Вызывайте API со своего сервера.

Что делать, если ключ утёк?

Отзовите его в личном кабинете в разделе «API и интеграции» — запросы с ним сразу перестанут работать — и создайте новый.

Нужен большой объём или работа внутри контура компании?

Для объёмов больше тарифов, договора и оплаты по счёту, а также для установки на ваши серверы посмотрите корпоративную и коробочную версии — API и MCP работают в них так же.

Получите API-ключ за минуту

Вход по коду на email, без пароля. Ключ, примеры и подключение MCP — в разделе «API и интеграции» личного кабинета.

Получить API-ключ

Нужен сервис под своим брендом? White Label · Установка на свои серверы: коробочная версия