← PDFtoSCAN Têketin / Mifteya API bistînin

Belgenamakirina API

Veguherandina PDFtoSCAN ji sepanên xwe bikar bînin. Hemû daxwazên API mifteyek API hewce dike (qeydkirin piştî bistînin).

URL-ya bingehîn

Hemû xalên dawîn nisbî ne:

https://pdftoscan.com/api/v1

Piştrast kirin

Bi bikaranîna yek ji van rêbazan mifteya API-ya xwe di her daxwazê de têxin:

Header Sernavî X-API-Key: mifteya-api-ya-we
Header Sernavî Authorization: Bearer mifteya-api-ya-we

Ji bo stenandina mifteya API: qeydkirin, paşê di Panela kontrolê-ya xwe de mifteyeke nû çêke. Miftey tenê carekê tê nîşandan—wê bi ewlehî hilînin.

Veguherîne rûyê skankirî

POST /convert.php

PDF an wêneyek bar bikin, an URL-ya pelê bişînin û PDF-yek bi rûyê skankirî bistînin (xwar, deng, paşxaneya pîs a dilxwaz, A4-ya dilxwaz).

Daxwaz

Rêbaz: POST
Content-Type: multipart/form-data (an application/x-www-form-urlencoded dema ku tenê file_url bikar tînin hûn dikarin application/x-www-form-urlencoded bikar bînin)

Parametreyan

Parametre	Cure	Hewce ye	Danasîn
`file` an `pdf`	file	Na	Pelê PDF, JPG, PNG, TIFF an WebP ji bo veguherandinê (barkirin). file an file_url bikar bînin.
`file_url`	string	Na	URL-ya HTTP(S) ya PDF-yek an wêneyekê ji bo veguherandinê. Barkirina pelê an file_url bikar bînin (herî zêde 50 MB, 30 s dema dawî).
`color_mode`	string	Na	color an bw. Pêşdanasîn: bw (reş-spî).
`rotate`	number	Na	Xwarbûna rûpelê bi dereceyan (-1.5 ji bo 1.5). Pêşdanasîn: 0.
`noise`	number	Na	Hejmara dengê 0–1. Pêşdanasîn: 0.1 (10%).
`dirty_background`	string	Na	1 (pêşdanasîn) ji bo nîşandana qerarên reşê pîs, 0 ji bo vemirandinê.
`force_a4`	string	Na	1 (pêşdanasîn) ji bo hevgirtîkirina derketinê bi A4-ê re, 0 ji bo parastin a mezinahiya orîjînal.

Bersiv

Serkeftin (200): Laşê bersivê pelê PDF e. Naverokê binary hilînin an stream bikin.

Xeletî (4xx/5xx): Laşê JSON: {"ok": false, "error": "Peyama xeletiyê"}

Kodên rewşê

Code	Wate
200	Serkeftin — bersiv PDF e.
400	Daxwaza xirab — pel tune, formata şaş an xeletiya barkirinê.
401	Destûr nîne — mifteya API tune an nederbasdar e.
405	Rêbaz destûr nîne — POST bikar bînin.
500	Xeletiya serverê — veguherandin têk çû.
503	Xizmet tune — veguherandin li ser serverê tune.

Mînak

cURL

Pelekê bar bikin:

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

An URL-ya pelê bişînin:

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

Daxwazên ji gerokan ji her çavkaniyekê destûr têne dayîn. Daxwazên OPTIONS-a pêşî piştgirî têne kirin.

Bikaranîn û sînor

Her veguherandinek li ser mifteya API tê jimartin. Di panela kontrola xwe de hûn dikarin bikaranîna giştî û bikaranîna di 7 û 30 rojên dawî de bibînin. Sînorên leza navxweyî tune; sînorên barkirina serverê û çavkaniyê dikarin bêne sepandin.

Formatên piştgirîkirî

Têketin: PDF, JPG, JPEG, PNG, TIFF, WebP.

Derketin: Her car PDF (bi rûyê skankirî).