← PDFtoSCAN Bejelentkezés / API kulcs beszerzése

API Dokumentáció

Használja a PDFtoSCAN átalakítást az alkalmazásaiból. Minden API kérés API kulcsot igényel (regisztráció után szerezzen be egyet).

Alap URL

Minden végpont relatív ehhez:

https://pdftoscan.com/api/v1

Hitelesítés

Foglalja bele API kulcsát minden kérésbe az alábbi módszerek egyikével:

Header Fejléc X-API-Key: az-ön-api-kulcsa
Header Fejléc Authorization: Bearer az-ön-api-kulcsa

API kulcs beszerzéséhez: regisztráció, majd az Irányítópult-ban generáljon új kulcsot. A kulcs csak egyszer jelenik meg—tárolja biztonságosan.

Átalakítás szkennelt megjelenésre

POST /convert.php

Töltsön fel PDF-et vagy képet, vagy küldjön fájl URL-t, és kapjon szkennelt megjelenésű PDF-et (dőlés, zaj, opcionális piszkos háttér, opcionális A4).

Kérés

Módszer: POST
Content-Type: multipart/form-data (vagy application/x-www-form-urlencoded csak file_url használatakor használhatja az application/x-www-form-urlencoded-ot)

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`file` vagy `pdf`	file	Nem	PDF, JPG, PNG, TIFF vagy WebP fájl átalakításhoz (feltöltés). Használja a file vagy file_url-t.
`file_url`	string	Nem	HTTP(S) URL egy PDF vagy kép átalakításához. Használja a fájl feltöltést vagy file_url-t (max. 50 MB, 30 s időtúllépés).
`color_mode`	string	Nem	color vagy bw. Alapértelmezett: bw (fekete-fehér).
`rotate`	number	Nem	Oldal dőlése fokban (-1.5-tól 1.5-ig). Alapértelmezett: 0.
`noise`	number	Nem	Zaj mennyisége 0–1. Alapértelmezett: 0.1 (10%).
`dirty_background`	string	Nem	1 (alapértelmezett) piszkos fekete szélek megjelenítéséhez, 0 a letiltáshoz.
`force_a4`	string	Nem	1 (alapértelmezett) a kimenet A4-hez illesztéséhez, 0 az eredeti méret megtartásához.

Válasz

Siker (200): A válasz törzse a PDF fájl. Mentse vagy streamelje a bináris tartalmat.

Hiba (4xx/5xx): JSON törzs: {"ok": false, "error": "Hibaüzenet"}

Állapotkódok

Code	Jelentés
200	Siker — a válasz a PDF.
400	Rossz kérés — hiányzó fájl, rossz formátum vagy feltöltési hiba.
401	Nem engedélyezett — hiányzó vagy érvénytelen API kulcs.
405	Módszer nem engedélyezett — használja a POST-ot.
500	Szerverhiba — az átalakítás sikertelen.
503	Szolgáltatás nem érhető el — az átalakítás nem érhető el a szerveren.

Példák

cURL

Fájl feltöltése:

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

Vagy fájl URL küldése:

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

A böngészőkből érkező kérések bármely eredetről engedélyezettek. A preflight OPTIONS kérések támogatottak.

Használat és korlátok

Minden átalakítás API kulcsonként számít. Az irányítópultján láthatja az összes használatot és az utolsó 7 és 30 nap használatát. Nincsenek beépített sebességkorlátok; a szerver feltöltési és erőforrás korlátai alkalmazhatók.

Támogatott formátumok

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

Kimenet: Mindig PDF (szkennelt megjelenéssel).