← PDFtoSCAN Hyrje / Merrni çelës API

Dokumentacion API

Përdorni konvertimin PDFtoSCAN nga aplikacionet tuaja. Të gjitha kërkesat API kërkojnë një çelës API (merrni një pas regjistrimit).

URL bazë

Të gjitha pikat përfundimtare janë relative ndaj:

https://pdftoscan.com/api/v1

Vërtetim

Përfshini çelësin tuaj API në çdo kërkesë duke përdorur një nga këto metoda:

Header Kryesore X-API-Key: çelësi-juaj-api
Header Kryesore Authorization: Bearer çelësi-juaj-api

Për të marrë një çelës API: regjistrimit, pastaj në Paneli tuaj gjeneroni një çelës të ri. Çelësi shfaqet vetëm një herë—ruajeni në mënyrë të sigurt.

Konverto në pamje të skanuar

POST /convert.php

Ngarkoni PDF ose imazh, ose dërgoni URL skedari, dhe merrni PDF me pamje të skanuar (pjerrësi, zhurmë, sfond i ndotur opsional, A4 opsional).

Kërkesë

Metodë: POST
Content-Type: multipart/form-data (ose application/x-www-form-urlencoded kur përdorni vetëm file_url mund të përdorni application/x-www-form-urlencoded)

Parametra

Parametër	Lloj	E kërkuar	Përshkrim
`file` ose `pdf`	file	Jo	Skedar PDF, JPG, PNG, TIFF ose WebP për të konvertuar (ngarkim). Përdorni file ose file_url.
`file_url`	string	Jo	URL HTTP(S) e një PDF ose imazhi për të konvertuar. Përdorni ngarkim skedari ose file_url (maks. 50 MB, 30 s kohë skadimi).
`color_mode`	string	Jo	color ose bw. Parazgjedhje: bw (bardh e zi).
`rotate`	number	Jo	Pjerrësia e faqes në gradë (-1.5 deri në 1.5). Parazgjedhje: 0.
`noise`	number	Jo	Sasia e zhurmës 0–1. Parazgjedhje: 0.1 (10%).
`dirty_background`	string	Jo	1 (parazgjedhje) për të shfaqur skaje të zeza të ndotura, 0 për të çaktivizuar.
`force_a4`	string	Jo	1 (parazgjedhje) për të përshtatur daljen në A4, 0 për të mbajtur madhësinë origjinale.

Përgjigje

Sukses (200): Trupi i përgjigjes është skedari PDF. Ruani ose transmetoni përmbajtjen binare.

Gabim (4xx/5xx): Trup JSON: {"ok": false, "error": "Mesazh gabimi"}

Kodet e statusit

Code	Kuptim
200	Sukses — përgjigja është PDF-ja.
400	Kërkesë e keqe — skedar që mungon, format i gabuar ose gabim ngarkimi.
401	I paautorizuar — çelës API që mungon ose i pavlefshëm.
405	Metodë e palejuar — përdorni POST.
500	Gabim serveri — konvertimi dështoi.
503	Shërbim i padisponueshëm — konvertimi nuk është i disponueshëm në server.

Shembuj

cURL

Ngarkoni një skedar:

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

Ose dërgoni një URL skedari:

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

Kërkesat nga shfletuesit lejohen nga çdo origjinë. Kërkesat OPTIONS preflight mbështeten.

Përdorimi dhe kufizimet

Çdo konvertim numërohet për çelës API. Në panelin tuaj mund të shihni përdorimin total dhe përdorimin gjatë 7 dhe 30 ditëve të fundit. Nuk ka kufizime të integruara të shpejtësisë; mund të aplikohen kufizime ngarkimi dhe burimesh të serverit.

Formate të mbështetura

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

Dalje: Gjithmonë PDF (me pamje të skanuar).