← 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	Жок	Айландыруу үчүн PDF же сүрөттүн HTTP(S) URL-и. Файлды жүктөө же 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 (сканерленген түр менен).