← 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 (ஸ்கேன் செய்த தோற்றத்துடன்).