← PDFtoSCAN ننوتل / د API کیلي ترلاسه کړئ

د API اسناد

د خپلو اپلیکیشنونو څخه د PDFtoSCAN بدلون وکاروئ. ټول API غوښتنې د API کیلي ته اړتیا لري (نوم لیکنه وروسته ترلاسه کړئ).

اساسي URL

ټول پای ټکي نسبي دي:

https://pdftoscan.com/api/v1

تصدیق

د دې میتودونو څخه یو په کارولو سره په هره غوښتنه کې خپل API کیلي شامل کړئ:

Header سرلیک X-API-Key: ستاسو-api-کیلي
Header سرلیک Authorization: Bearer ستاسو-api-کیلي

د API کیلي ترلاسه کولو لپاره: نوم لیکنه، بیا په خپل ډشبورډ کې نوی کیلي جوړ کړئ. کیلي یوازې یو ځل ښودل کیږي—دا په خوندي ډول زیرمه کړئ.

سکین شوی بڼې ته بدل کړئ

POST /convert.php

PDF یا انځور اپلوډ کړئ، یا د فایل URL واستوئ او د سکین شوی بڼې سره PDF ترلاسه کړئ (کجه، غږ، اختیاري کثیف شالید، اختیاري A4).

غوښتنه

میتود: POST
Content-Type: multipart/form-data (یا application/x-www-form-urlencoded کله چې یوازې file_url کاروئ تاسو کولی شئ application/x-www-form-urlencoded وکاروئ)

پیرامیټرونه

پیرامیټر	ډول	اړین	تشریح
`file` یا `pdf`	file	نه	د بدلون لپاره PDF، JPG، PNG، TIFF یا WebP فایل (اپلوډ). file یا file_url وکاروئ.
`file_url`	string	نه	د بدلون لپاره د PDF یا انځور HTTP(S) URL. د فایل اپلوډ یا file_url وکاروئ (اعظمي 50 MB، 30 s وخت ختمیدل).
`color_mode`	string	نه	color یا bw. ډیفالټ: bw (تور-سپین).
`rotate`	number	نه	په درجو کې د مخ کجه (-1.5 څخه 1.5 پورې). ډیفالټ: 0.
`noise`	number	نه	د غږ مقدار 0–1. ډیفالټ: 0.1 (10%).
`dirty_background`	string	نه	1 (ډیفالټ) د کثیف تور څنډو د ښودلو لپاره، 0 د بندولو لپاره.
`force_a4`	string	نه	1 (ډیفالټ) محصول A4 ته د سمون لپاره، 0 د اصلي اندازې د ساتلو لپاره.

ځواب

بریا (200): د ځواب بدن PDF فایل دی. بائنري مینځپانګه زیرمه یا سټریم کړئ.

تېروتنه (4xx/5xx): JSON بدن: {"ok": false, "error": "د تېروتنې پیغام"}

د حالت کوډونه

Code	معنی
200	بریا — ځواب PDF دی.
400	بده غوښتنه — فایل نشته، غلط بڼه یا د اپلوډ تېروتنه.
401	غیر مجاز — د API کیلي نشته یا ناباوره.
405	میتود ته اجازه نشته — POST وکاروئ.
500	د سرور تېروتنه — بدلون ناکام شو.
503	خدمت شتون نلري — په سرور کې بدلون شتون نلري.

مثالونه

cURL

فایل اپلوډ کړئ:

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

یا د فایل URL واستوئ:

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

د براوزرونو څخه غوښتنې د کوم سرچینې څخه اجازه لري. د Preflight OPTIONS غوښتنې ملاتړ کیږي.

کارونه او محدودیتونه

هر بدلون د API کیلي په اساس شمیرل کیږي. په خپل ډشبورډ کې تاسو کولی شئ ټول کارونه او د وروستیو 7 او 30 ورځو کارونه وګورئ. جوړ شوي سرعت محدودیتونه نشته؛ د سرور اپلوډ او سرچینو محدودیتونه پلي کیدی شي.

ملاتړ شوي بڼې

ننوتل: PDF، JPG، JPEG، PNG، TIFF، WebP.

وتل: تل PDF (د سکین شوی بڼې سره).