← 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 (сканерленген түрмен).