ឯកសារ 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	ទេ	URL HTTP(S) នៃ PDF ឬរូបភាពដើម្បីបំប្លែង។ ប្រើការផ្ទុកឡើងឯកសារ ឬ 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

សំណើពីកម្មវិធីរុករកត្រូវបានអនុញ្ញាតពីប្រភពណាមួយ។ សំណើ OPTIONS preflight ត្រូវបានគាំទ្រ។

ការប្រើប្រាស់និងដែនកំណត់

ការបំប្លែងនីមួយៗត្រូវបានរាប់តាមគន្លឹះ API។ នៅក្នុងផ្ទាំងគ្រប់គ្រងរបស់អ្នក អ្នកអាចមើលការប្រើប្រាស់សរុប និងការប្រើប្រាស់ក្នុងរយៈពេល 7 និង 30 ថ្ងៃចុងក្រោយ។ គ្មានដែនកំណត់អត្រាដែលបង្កើតក្នុង; ដែនកំណត់ការផ្ទុកឡើង និងធនធានម៉ាស៊ីនមេអាចត្រូវបានអនុវត្ត។

ទម្រង់ដែលគាំទ្រ

ការបញ្ចូល៖ PDF, JPG, JPEG, PNG, TIFF, WebP។

លទ្ធផល៖ តែងតែ PDF (ជាមួយរូបរាងស្កេន)។