← PDFtoSCAN Prijava / Pridobite API ključ

API Dokumentacija

Uporabite PDFtoSCAN pretvorbo iz svojih aplikacij. Vse API zahteve zahtevajo API ključ (pridobite po registraciji).

Osnovni URL

Vse končne točke so relativne glede na:

https://pdftoscan.com/api/v1

Avtentikacija

Vključite svoj API ključ v vsako zahtevo z uporabo ene od teh metod:

Header Glava X-API-Key: vaš-api-ključ
Header Glava Authorization: Bearer vaš-api-ključ

Za pridobitev API ključa: registraciji, nato v svoji Nadzorna plošča generirajte nov ključ. Ključ se prikaže samo enkrat—shranite ga varno.

Pretvori v skeniran videz

POST /convert.php

Naložite PDF ali sliko ali pošljite URL datoteke in prejmite PDF s skeniranim videzom (nagib, šum, neobvezno umazano ozadje, neobvezno A4).

Zahteva

Metoda: POST
Content-Type: multipart/form-data (ali application/x-www-form-urlencoded ko uporabljate samo file_url lahko uporabite application/x-www-form-urlencoded)

Parametri

Parameter	Tip	Obvezno	Opis
`file` ali `pdf`	file	Ne	PDF, JPG, PNG, TIFF ali WebP datoteka za pretvorbo (nalaganje). Uporabite file ali file_url.
`file_url`	string	Ne	HTTP(S) URL PDF-ja ali slike za pretvorbo. Uporabite nalaganje datoteke ali file_url (maks. 50 MB, 30 s časovna omejitev).
`color_mode`	string	Ne	color ali bw. Privzeto: bw (črno-belo).
`rotate`	number	Ne	Nagib strani v stopinjah (-1.5 do 1.5). Privzeto: 0.
`noise`	number	Ne	Količina šuma 0–1. Privzeto: 0.1 (10%).
`dirty_background`	string	Ne	1 (privzeto) za prikaz umazanih črnih robov, 0 za onemogočanje.
`force_a4`	string	Ne	1 (privzeto) za prilagoditev izhoda na A4, 0 za ohranitev izvorne velikosti.

Odgovor

Uspeh (200): Telo odgovora je PDF datoteka. Shranite ali pretočite binarno vsebino.

Napaka (4xx/5xx): JSON telo: {"ok": false, "error": "Sporočilo o napaki"}

Statusne kode

Code	Pomen
200	Uspeh — odgovor je PDF.
400	Slaba zahteva — manjkajoča datoteka, napačen format ali napaka pri nalaganju.
401	Nepooblaščen — manjkajoč ali neveljaven API ključ.
405	Metoda ni dovoljena — uporabite POST.
500	Napaka strežnika — pretvorba ni uspela.
503	Storitev ni na voljo — pretvorba ni na voljo na strežniku.

Primeri

cURL

Naložite datoteko:

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

Ali pošljite URL datoteke:

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

Zahteve iz brskalnikov so dovoljene iz katerega koli izvora. Preflight OPTIONS zahteve so podprte.

Uporaba in omejitve

Vsaka pretvorba se šteje na API ključ. V svoji nadzorni plošči lahko vidite skupno uporabo in uporabo v zadnjih 7 in 30 dneh. Ni vgrajenih omejitev hitrosti; lahko se uporabijo omejitve nalaganja in virov strežnika.

Podprti formati

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

Izhod: Vedno PDF (s skeniranim videzom).