← 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 (स्क्यान गरिएको रूपको साथ).