เอกสาร API

ใช้การแปลง PDFtoSCAN จากแอปพลิเคชันของคุณ คำขอ API ทั้งหมดต้องการคีย์ API (รับหลัง ลงทะเบียน)

URL ฐาน

endpoint ทั้งหมดสัมพันธ์กับ:

https://pdftoscan.com/api/v1

การยืนยันตัวตน

รวมคีย์ API ของคุณในทุกคำขอโดยใช้วิธีใดวิธีหนึ่งเหล่านี้:

Header Header X-API-Key: คีย์-api-ของคุณ
Header 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 วินาที)
`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 เสมอ (ที่มีลักษณะสแกน)