← PDFtoSCAN Prijava / Dobijte API ključ

API Dokumentacija

Koristite PDFtoSCAN pretvaranje iz svojih aplikacija. Svi API zahtjevi zahtijevaju API ključ (dobijte nakon registracije).

Osnovni URL

Sve krajnje točke su relativne prema:

https://pdftoscan.com/api/v1

Autentifikacija

Uključite svoj API ključ u svaki zahtjev koristeći jednu od ovih metoda:

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

Za dobivanje API ključa: registracije, zatim u svom Kontrolna tabla generirajte novi ključ. Ključ se prikazuje samo jednom—pohranite ga sigurno.

Pretvorite u skenirani izgled

POST /convert.php

Prenesite PDF ili sliku, ili pošaljite URL datoteke, i primite PDF sa skeniranim izgledom (nagib, šum, opcionalna prljava pozadina, opcionalni A4).

Zahtjev

Metoda: POST
Content-Type: multipart/form-data (ili application/x-www-form-urlencoded kada koristite samo file_url možete koristiti application/x-www-form-urlencoded)

Parametri

Parametar	Tip	Obavezno	Opis
`file` ili `pdf`	file	Ne	PDF, JPG, PNG, TIFF ili WebP datoteka za pretvaranje (prijenos). Koristite file ili file_url.
`file_url`	string	Ne	HTTP(S) URL PDF-a ili slike za pretvaranje. Koristite prijenos datoteke ili file_url (maks. 50 MB, 30 s istek vremena).
`color_mode`	string	Ne	color ili bw. Zadano: bw (crno-bijelo).
`rotate`	number	Ne	Nagib stranice u stepenima (-1.5 do 1.5). Zadano: 0.
`noise`	number	Ne	Količina šuma 0–1. Zadano: 0.1 (10%).
`dirty_background`	string	Ne	1 (zadano) za prikaz prljivih crnih rubova, 0 za deaktiviranje.
`force_a4`	string	Ne	1 (zadano) za prilagodbu izlaza na A4, 0 za zadržavanje izvorne veličine.

Odgovor

Uspjeh (200): Tijelo odgovora je PDF datoteka. Spremite ili strujajte binarni sadržaj.

Greška (4xx/5xx): JSON tijelo: {"ok": false, "error": "Poruka greške"}

Statusni kodovi

Code	Značenje
200	Uspjeh — odgovor je PDF.
400	Loš zahtjev — nedostaje datoteka, pogrešan format ili greška prijenosa.
401	Neovlašten — nedostaje ili nevažeći API ključ.
405	Metoda nije dopuštena — koristite POST.
500	Greška servera — pretvaranje nije uspjelo.
503	Usluga nije dostupna — pretvaranje nije dostupno na serveru.

Primjeri

cURL

Prenesite datoteku:

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

Ili pošaljite 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

Zahtjevi iz preglednika su dopušteni iz bilo kojeg izvora. Preflight OPTIONS zahtjevi su podržani.

Upotreba i ograničenja

Svako pretvaranje se broji po API ključu. U svojoj kontrolnoj tabli možete vidjeti ukupnu upotrebu i upotrebu tijekom zadnjih 7 i 30 dana. Nema ugrađenih ograničenja brzine; mogu se primijeniti ograničenja prijenosa i resursa servera.

Podržani formati

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

Izlaz: Uvijek PDF (sa skeniranim izgledom).