← PDFtoSCAN Đăng nhập / Nhận khóa API

Tài liệu API

Sử dụng chuyển đổi PDFtoSCAN từ ứng dụng của bạn. Tất cả các yêu cầu API đều cần khóa API (nhận sau đăng ký).

URL cơ sở

Tất cả các điểm cuối đều tương đối với:

https://pdftoscan.com/api/v1

Xác thực

Bao gồm khóa API của bạn trong mỗi yêu cầu bằng một trong các phương thức sau:

Header Header X-API-Key: khóa-api-của-bạn
Header Header Authorization: Bearer khóa-api-của-bạn

Để nhận khóa API: đăng ký, sau đó trong Bảng điều khiển của bạn tạo khóa mới. Khóa chỉ được hiển thị một lần—lưu trữ an toàn.

Chuyển đổi thành vẻ ngoài đã quét

POST /convert.php

Tải lên PDF hoặc hình ảnh, hoặc gửi URL tệp, và nhận PDF có vẻ ngoài đã quét (nghiêng, nhiễu, nền bẩn tùy chọn, A4 tùy chọn).

Yêu cầu

Phương thức: POST
Content-Type: multipart/form-data (hoặc application/x-www-form-urlencoded khi chỉ sử dụng file_url bạn có thể sử dụng application/x-www-form-urlencoded)

Tham số

Tham số	Loại	Bắt buộc	Mô tả
`file` hoặc `pdf`	file	Không	Tệp PDF, JPG, PNG, TIFF hoặc WebP để chuyển đổi (tải lên). Sử dụng file hoặc file_url.
`file_url`	string	Không	URL HTTP(S) của PDF hoặc hình ảnh để chuyển đổi. Sử dụng tải lên tệp hoặc file_url (tối đa 50 MB, thời gian chờ 30 giây).
`color_mode`	string	Không	color hoặc bw. Mặc định: bw (đen trắng).
`rotate`	number	Không	Độ nghiêng trang theo độ (-1.5 đến 1.5). Mặc định: 0.
`noise`	number	Không	Lượng nhiễu 0–1. Mặc định: 0.1 (10%).
`dirty_background`	string	Không	1 (mặc định) để hiển thị viền đen bẩn, 0 để tắt.
`force_a4`	string	Không	1 (mặc định) để điều chỉnh đầu ra vào A4, 0 để giữ kích thước gốc.

Phản hồi

Thành công (200): Nội dung phản hồi là tệp PDF. Lưu hoặc truyền nội dung nhị phân.

Lỗi (4xx/5xx): Nội dung JSON: {"ok": false, "error": "Thông báo lỗi"}

Mã trạng thái

Code	Ý nghĩa
200	Thành công — phản hồi là PDF.
400	Yêu cầu không hợp lệ — thiếu tệp, định dạng sai hoặc lỗi tải lên.
401	Không được phép — thiếu hoặc khóa API không hợp lệ.
405	Phương thức không được phép — sử dụng POST.
500	Lỗi máy chủ — chuyển đổi thất bại.
503	Dịch vụ không khả dụng — chuyển đổi không khả dụng trên máy chủ.

Ví dụ

cURL

Tải lên tệp:

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

Hoặc gửi URL tệp:

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

Yêu cầu từ trình duyệt được phép từ bất kỳ nguồn gốc nào. Yêu cầu OPTIONS preflight được hỗ trợ.

Sử dụng và giới hạn

Mỗi chuyển đổi được tính theo khóa API. Trong bảng điều khiển của bạn, bạn có thể xem tổng số sử dụng và sử dụng trong 7 và 30 ngày qua. Không có giới hạn tốc độ tích hợp; giới hạn tải lên và tài nguyên máy chủ có thể áp dụng.

Định dạng được hỗ trợ

Đầu vào: PDF, JPG, JPEG, PNG, TIFF, WebP.

Đầu ra: Luôn là PDF (có vẻ ngoài đã quét).