← PDFtoSCAN ဝင်ရောက်ပါ / API သော့ ရယူပါ

API မှတ်တမ်းများ

သင့် အပလီကေးရှင်းများမှ PDFtoSCAN ပြောင်းလဲမှုကို အသုံးပြုပါ။ API တောင်းဆိုချက် အားလုံးသည် API သော့ လိုအပ်သည် (မှတ်ပုံတင်ခြင်း ပြီးနောက် ရယူပါ)။

အခြေခံ URL

အဆုံးမှတ် အားလုံးသည် ဆွေမျိုးဖြစ်သည် -

https://pdftoscan.com/api/v1

စစ်မှန်ကြောင်း အတည်ပြုခြင်း

ဤနည်းလမ်းများထဲမှ တစ်ခုကို အသုံးပြု၍ တောင်းဆိုချက် တစ်ခုစီတွင် သင့် API သော့ကို ထည့်သွင်းပါ -

Header ခေါင်းစီး X-API-Key: သင့်-api-သော့
Header ခေါင်းစီး Authorization: Bearer သင့်-api-သော့

API သော့ ရယူရန် - မှတ်ပုံတင်ခြင်း၊ ထို့နောက် သင့် ဒက်ရှ်ဘုတ် တွင် သော့အသစ် ထုတ်လုပ်ပါ။ သော့ကို တစ်ကြိမ်သာ ပြသသည်—၎င်းကို လုံခြုံစွာ သိမ်းဆည်းပါ။

scan လုပ်ထားသော အသွင်သို့ ပြောင်းလဲပါ

POST /convert.php

PDF သို့မဟုတ် ပုံတင်ပါ၊ သို့မဟုတ် ဖိုင် URL ပို့ပါ ပြီး scan လုပ်ထားသော အသွင်ရှိ 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 ဖိုင်ဖြစ်သည်။ ဒွိရဲ့ အကြောင်းအရာကို သိမ်းဆည်း သို့မဟုတ် stream လုပ်ပါ။

အမှား (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 (scan လုပ်ထားသော အသွင်ဖြင့်)။