← 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	Не	HTTP(S) URL на PDF или изображение за конвертиране. Използвайте качване на файл или file_url (макс. 50 MB, 30 s таймаут).
`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

Заявките от браузъри са разрешени от всякакъв произход. Preflight OPTIONS заявките се поддържат.

Използване и ограничения

Всяко конвертиране се брои на API ключ. В таблото си за управление можете да видите общото използване и използването през последните 7 и 30 дни. Няма вградени ограничения на скоростта; могат да се прилагат ограничения за качване и ресурси на сървъра.

Поддържани формати

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

Изход: Винаги PDF (със сканиран вид).