← 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 (со скениран изглед).