← PDFtoSCAN Kirish / API kalitini olish

API Hujjatlari

Ilovalaringizdan PDFtoSCAN aylantirishdan foydalaning. Barcha API so'rovlari API kalitini talab qiladi (ro'yxatdan o'tish dan keyin oling).

Asosiy URL

Barcha oxirgi nuqtalar nisbiydir:

https://pdftoscan.com/api/v1

Autentifikatsiya

Ushbu usullardan birini ishlatib har bir so'rovga API kalitingizni qo'shing:

Header Sarlavha X-API-Key: sizning-api-kalitingiz
Header Sarlavha Authorization: Bearer sizning-api-kalitingiz

API kalitini olish uchun: ro'yxatdan o'tish, keyin Boshqaruv paneli-da yangi kalit yarating. Kalit faqat bir marta ko'rsatiladi—uni xavfsiz saqlang.

Skanerlangan ko'rinishga aylantirish

POST /convert.php

PDF yoki rasmni yuklang, yoki fayl URL-ni yuboring va skanerlangan ko'rinishdagi PDF oling (qiyshayish, shovqin, ixtiyoriy iflos fon, ixtiyoriy A4).

So'rov

Usul: POST
Content-Type: multipart/form-data (yoki application/x-www-form-urlencoded faqat file_url ishlatilganda application/x-www-form-urlencoded ishlatishingiz mumkin)

Parametrlar

Parametr	Turi	Talab qilinadi	Tavsif
`file` yoki `pdf`	file	Yo'q	Aylantirish uchun PDF, JPG, PNG, TIFF yoki WebP fayli (yuklash). file yoki file_url ishlatıng.
`file_url`	string	Yo'q	Aylantirish uchun PDF yoki rasmning HTTP(S) URL-i. Fayl yuklash yoki file_url ishlatıng (maks. 50 MB, 30 s vaqt cheklovi).
`color_mode`	string	Yo'q	color yoki bw. Standart: bw (qora-oq).
`rotate`	number	Yo'q	Darajada sahifa qiyshayishi (-1.5 dan 1.5 gacha). Standart: 0.
`noise`	number	Yo'q	Shovqin miqdori 0–1. Standart: 0.1 (10%).
`dirty_background`	string	Yo'q	1 (standart) iflos qora chetlarni ko'rsatish uchun, 0 o'chirish uchun.
`force_a4`	string	Yo'q	1 (standart) chiqishni A4-ga moslashtirish uchun, 0 asl o'lchamni saqlash uchun.

Javob

Muvaffaqiyat (200): Javob tanasi PDF faylidir. Ikkilik tarkibni saqlang yoki oqim qiling.

Xato (4xx/5xx): JSON tanasi: {"ok": false, "error": "Xato xabari"}

Holat kodlari

Code	Ma'nosi
200	Muvaffaqiyat — javob PDF.
400	Yomon so'rov — fayl yo'q, noto'g'ri format yoki yuklash xatosi.
401	Ruxsat etilmagan — API kaliti yo'q yoki noto'g'ri.
405	Usulga ruxsat berilmagan — POST ishlatıng.
500	Server xatosi — aylantirish muvaffaqiyatsiz tugadi.
503	Xizmat mavjud emas — serverda aylantirish mavjud emas.

Misollar

cURL

Fayl yuklash:

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

Yoki fayl URL-ni yuborish:

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

Brauzerlardan so'rovlar har qanday manbadan ruxsat etilgan. Preflight OPTIONS so'rovlari qo'llab-quvvatlanadi.

Foydalanish va cheklovlar

Har bir aylantirish API kaliti bo'yicha hisoblanadi. Boshqaruv panelingizda umumiy foydalanishni va oxirgi 7 va 30 kun ichidagi foydalanishni ko'rishingiz mumkin. O'rnatilgan tezlik cheklovlari yo'q; server yuklash va resurs cheklovlari qo'llanilishi mumkin.

Qo'llab-quvvatlanadigan formatlar

Kirish: PDF, JPG, JPEG, PNG, TIFF, WebP.

Chiqish: Har doim PDF (skanerlangan ko'rinish bilan).