← PDFtoSCAN Нэвтрэх / API түлхүүр авах

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 (скан хийсэн харагдацтай).