← 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 (স্ক্যান করা চেহারা সহ)।