← 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 (اسکین شدہ شکل کے ساتھ)۔