← PDFtoSCAN Prihlásiť sa / Získať API kľúč

Dokumentácia API

Používajte prevod PDFtoSCAN zo svojich aplikácií. Všetky API požiadavky vyžadujú API kľúč (získajte po registrácii).

Základná URL

Všetky koncové body sú relatívne k:

https://pdftoscan.com/api/v1

Autentifikácia

Zahrňte svoj API kľúč do každej požiadavky pomocou jednej z týchto metód:

Header Hlavička X-API-Key: váš-api-kľúč
Header Hlavička Authorization: Bearer váš-api-kľúč

Pre získanie API kľúča: registrácii, potom vo svojom Ovládací panel vygenerujte nový kľúč. Kľúč je zobrazený iba raz—uložte ho bezpečne.

Previesť na naskenovaný vzhľad

POST /convert.php

Nahrajte PDF alebo obrázok, alebo pošlite URL súboru, a obdržte PDF s naskenovaným vzhľadom (náklon, šum, voliteľné špinavé pozadie, voliteľné A4).

Požiadavka

Metóda: POST
Content-Type: multipart/form-data (alebo application/x-www-form-urlencoded pri použití iba file_url môžete použiť application/x-www-form-urlencoded)

Parametre

Parameter	Typ	Povinný	Popis
`file` alebo `pdf`	file	Nie	Súbor PDF, JPG, PNG, TIFF alebo WebP na prevod (nahratie). Použite file alebo file_url.
`file_url`	string	Nie	HTTP(S) URL PDF alebo obrázku na prevod. Použite nahratie súboru alebo file_url (max. 50 MB, 30 s timeout).
`color_mode`	string	Nie	color alebo bw. Predvolené: bw (čiernobiely).
`rotate`	number	Nie	Náklon stránky v stupňoch (-1.5 až 1.5). Predvolené: 0.
`noise`	number	Nie	Množstvo šumu 0–1. Predvolené: 0.1 (10%).
`dirty_background`	string	Nie	1 (predvolené) pre zobrazenie špinavých čiernych okrajov, 0 pre deaktiváciu.
`force_a4`	string	Nie	1 (predvolené) pre prispôsobenie výstupu na A4, 0 pre zachovanie pôvodnej veľkosti.

Odpoveď

Úspech (200): Telo odpovede je súbor PDF. Uložte alebo streamujte binárny obsah.

Chyba (4xx/5xx): JSON telo: {"ok": false, "error": "Chybová správa"}

Stavové kódy

Code	Význam
200	Úspech — odpoveď je PDF.
400	Zlá požiadavka — chýba súbor, zlý formát alebo chyba nahrávania.
401	Neautorizovaný — chýba alebo neplatný API kľúč.
405	Metóda nie je povolená — použite POST.
500	Chyba servera — prevod zlyhal.
503	Služba nedostupná — prevod nie je na serveri k dispozícii.

Príklady

cURL

Nahrať súbor:

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

Alebo poslať URL súboru:

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

Požiadavky z prehliadačov sú povolené z akéhokoľvek pôvodu. Preflight OPTIONS požiadavky sú podporované.

Využitie a limity

Každý prevod sa počíta na API kľúč. Vo svojom ovládacom paneli môžete vidieť celkové využitie a využitie za posledných 7 a 30 dní. Neexistujú žiadne vstavané limity rýchlosti; môžu platiť limity nahrávania a zdrojov servera.

Podporované formáty

Vstup: PDF, JPG, JPEG, PNG, TIFF, WebP.

Výstup: Vždy PDF (s naskenovaným vzhľadom).