← PDFtoSCAN Увійти / Отримати ключ API

Документація API

Використовуйте конвертацію PDFtoSCAN зі своїх додатків. Усі запити API вимагають ключа API (отримайте після реєстрації).

Базовий URL

Усі кінцеві точки відносні до:

https://pdftoscan.com/api/v1

Автентифікація

Включіть свій ключ API в кожен запит, використовуючи один з цих методів:

Header Заголовок X-API-Key: ваш-ключ-api
Header Заголовок Authorization: Bearer ваш-ключ-api

Щоб отримати ключ API: реєстрації, потім у своїй Панель керування створіть новий ключ. Ключ показується лише один раз—зберігайте його безпечно.

Конвертувати у вигляд скану

POST /convert.php

Завантажте PDF або зображення, або надішліть URL файлу, і отримайте PDF з виглядом скану (нахил, шум, необов'язковий брудний фон, необов'язковий A4).

Запит

Метод: POST
Content-Type: multipart/form-data (або application/x-www-form-urlencoded при використанні лише file_url ви можете використовувати application/x-www-form-urlencoded)

Параметри

Параметр	Тип	Обов'язковий	Опис
`file` або `pdf`	file	Ні	Файл PDF, JPG, PNG, TIFF або WebP для конвертації (завантаження). Використовуйте file або file_url.
`file_url`	string	Ні	URL HTTP(S) PDF або зображення для конвертації. Використовуйте завантаження файлу або file_url (макс. 50 МБ, таймаут 30 с).
`color_mode`	string	Ні	color або bw. За замовчуванням: bw (чорно-білий).
`rotate`	number	Ні	Нахил сторінки в градусах (-1.5 до 1.5). За замовчуванням: 0.
`noise`	number	Ні	Кількість шуму 0–1. За замовчуванням: 0.1 (10%).
`dirty_background`	string	Ні	1 (за замовчуванням) для показу брудних чорних країв, 0 для вимкнення.
`force_a4`	string	Ні	1 (за замовчуванням) для підгону виходу до A4, 0 для збереження оригінального розміру.

Відповідь

Успіх (200): Тіло відповіді — файл PDF. Збережіть або передайте бінарний вміст.

Помилка (4xx/5xx): Тіло JSON: {"ok": false, "error": "Повідомлення про помилку"}

Коди статусу

Code	Значення
200	Успіх — відповідь це PDF.
400	Поганий запит — відсутній файл, неправильний формат або помилка завантаження.
401	Неавторизований — відсутній або недійсний ключ API.
405	Метод не дозволений — використовуйте POST.
500	Помилка сервера — конвертація не вдалася.
503	Сервіс недоступний — конвертація недоступна на сервері.

Приклади

cURL

Завантажити файл:

curl -X POST "https://pdftoscan.com/api/v1/convert.php" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "color_mode=bw" \
  -F "force_a4=1" \
  -o scanned.pdf

Або надіслати URL файлу:

curl -X POST "https://pdftoscan.com/api/v1/convert.php" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "file_url=https://example.com/document.pdf" \
  -d "color_mode=bw" \
  -d "force_a4=1" \
  -o scanned.pdf

JavaScript (fetch)

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('color_mode', 'bw');
formData.append('force_a4', '1');

const response = await fetch('https://pdftoscan.com/api/v1/convert.php', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: formData
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(err.error || 'Request failed');
}
const blob = await response.blob();
// e.g. save or open blob as PDF

Python

import requests

url = 'https://pdftoscan.com/api/v1/convert.php'
headers = {'X-API-Key': 'YOUR_API_KEY'}
files = {'file': open('document.pdf', 'rb')}
data = {'color_mode': 'bw', 'force_a4': '1'}

r = requests.post(url, headers=headers, files=files, data=data)

if r.status_code != 200:
    print(r.json().get('error', 'Error'))
else:
    with open('scanned.pdf', 'wb') as f:
        f.write(r.content)

CORS

Запити з браузерів дозволені з будь-якого джерела. Підтримуються запити OPTIONS preflight.

Використання та обмеження

Кожна конвертація рахується за ключем API. У своїй панелі керування ви можете побачити загальне використання та використання за останні 7 і 30 днів. Немає вбудованих обмежень швидкості; можуть застосовуватися обмеження завантаження та ресурсів сервера.

Підтримувані формати

Вхід: PDF, JPG, JPEG, PNG, TIFF, WebP.

Вихід: Завжди PDF (з виглядом скану).