pdf2scan API

REST · JSON · for business

Программно превращайте PDF и Word в «скан»: эффект сканирования, сшивка, нумерация, титульный лист, PDF/A. Идеально для юрфирм, бухгалтерий, документооборота и тендерных отделов.

Programmatically turn PDF/Word into scanned documents — scan effect, binding, numbering, PDF/A. Built for integrations.

Базовый URL / Base URL: https://pdf2scan.online/api/v1
Аутентификация: заголовок Authorization: Bearer <api_key> или X-API-Key: <api_key>
Лимит: 60 запросов/мин на ключ (пробный тариф).

1. Получить ключ / Get an API key

Ключи привязаны к Telegram-аккаунту. Пока сервис бесплатный (тарифы и оплату добавим позже).

Ваш ключ (показывается один раз — сохраните!):

Либо напишите @berkio — выдадим ключ вручную.

2. Отправить файл / Submit a file

POST/api/v1/scan — multipart/form-data

Поле	Тип	По умолчанию	Описание
file	file	—	PDF / DOC / DOCX
stitching	string	без сшивки	нитка · ленточка · уголок · пружинка · дырокол · без сшивки
color	string	color	`color` или `bw`
quality	string	high	`high` (300 DPI) · `medium` (250) · `low` (200)
numeration	0/1	0	нумерация страниц
title	0/1	0	титульный лист
flip_side	0/1	0	лист «прошито-пронумеровано»
pdfa	0/1	0	формат PDF/A

Пример / Example

curl -X POST https://pdf2scan.online/api/v1/scan \
  -H "Authorization: Bearer sk_your_key_here" \
  -F "file=@document.pdf" \
  -F "stitching=нитка" \
  -F "color=bw" \
  -F "numeration=1" \
  -F "pdfa=1"

Ответ / Response

{
  "job_id": "2026.07.02_12-40-11_document",
  "pages": 14,
  "status_url": "/api/v1/scan/2026.07.02_12-40-11_document",
  "download_url": "/api/v1/scan/2026.07.02_12-40-11_document/download"
}

3. Проверить статус / Check status

GET/api/v1/scan/{job_id}

curl https://pdf2scan.online/api/v1/scan/JOB_ID \
  -H "Authorization: Bearer sk_your_key_here"

# { "status": "queued", "queue_pos": 3 }
# { "status": "processing", "queue_pos": 0 }
# { "status": "done", "download_url": "/api/v1/scan/JOB_ID/download" }

4. Скачать результат / Download result

GET/api/v1/scan/{job_id}/download — возвращает PDF (готов ~6 часов).

curl -L https://pdf2scan.online/api/v1/scan/JOB_ID/download \
  -H "Authorization: Bearer sk_your_key_here" \
  -o scan.pdf

Коды ошибок / Errors

Код	Значение
401	Нет ключа / ключ неверный или отключён
409	Файл ещё не готов (проверьте статус)
413	Файл слишком большой
429	Превышен лимит запросов

pdf2scan.online · Главная · Вопросы по API — @berkio