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 (ಸ್ಕ್ಯಾನ್ ಮಾಡಿದ ನೋಟದೊಂದಿಗೆ).