← PDFtoSCAN Daxil olun / API açarı əldə edin

API Sənədləşməsi

Tətbiqlərinizd ən PDFtoSCAN çevrilməsindən istifadə edin. Bütün API sorğuları API açarı tələb edir (qeydiyyat sonra əldə edin).

Əsas URL

Bütün son nöqtələr nisbidir:

https://pdftoscan.com/api/v1

Autentifikasiya

Bu metodlardan birini istifadə edərək hər sorğuda API açarınızı daxil edin:

Header Başlıq X-API-Key: sizin-api-açarınız
Header Başlıq Authorization: Bearer sizin-api-açarınız

API açarı əldə etmək üçün: qeydiyyat, sonra İdarə paneli-də yeni açar yaradın. Açar yalnız bir dəfə göstərilir—onu təhlükəsiz saxlayın.

Skan edilmiş görünüşə çevirin

POST /convert.php

PDF və ya şəkil yükləyin, və ya fayl URL göndərin və skan edilmiş görünüşlü PDF əldə edin (əyilmə, səs-küy, isteğe bağlı çirkli fon, isteğe bağlı A4).

Sorğu

Metod: POST
Content-Type: multipart/form-data (və ya application/x-www-form-urlencoded yalnız file_url istifadə edərkən application/x-www-form-urlencoded istifadə edə bilərsiniz)

Parametrlər

Parametr	Növ	Tələb olunur	Təsvir
`file` və ya `pdf`	file	Xeyr	Çevirmək üçün PDF, JPG, PNG, TIFF və ya WebP faylı (yükləmə). file və ya file_url istifadə edin.
`file_url`	string	Xeyr	Çevirmək üçün PDF və ya şəklin HTTP(S) URL-i. Fayl yükləmə və ya file_url istifadə edin (maks. 50 MB, 30 s vaxt aşımı).
`color_mode`	string	Xeyr	color və ya bw. Varsayılan: bw (ağ-qara).
`rotate`	number	Xeyr	Dərəcələrlə səhifə əyilməsi (-1.5-dən 1.5-ə). Varsayılan: 0.
`noise`	number	Xeyr	Səs-küy miqdarı 0–1. Varsayılan: 0.1 (10%).
`dirty_background`	string	Xeyr	1 (varsayılan) çirkli qara kənarları göstərmək üçün, 0 söndürmək üçün.
`force_a4`	string	Xeyr	1 (varsayılan) çıxışı A4-ə uyğunlaşdırmaq üçün, 0 orijinal ölçünü saxlamaq üçün.

Cavab

Uğur (200): Cavab gövdəsi PDF faylıdır. İkili məzmunu saxlayın və ya yayımlayın.

Xəta (4xx/5xx): JSON gövdəsi: {"ok": false, "error": "Xəta mesajı"}

Status kodları

Code	Mənası
200	Uğur — cavab PDF-dir.
400	Pis sorğu — fayl yoxdur, yanlış format və ya yükləmə xətası.
401	İcazəsiz — API açarı yoxdur və ya etibarsızdır.
405	Metoda icazə verilmir — POST istifadə edin.
500	Server xətası — çevirmə uğursuz oldu.
503	Xidmət əlçatan deyil — serverdə çevirmə əlçatan deyil.

Nümunələr

cURL

Fayl yükləyin:

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

Və ya fayl URL göndərin:

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

Brauzerlərdən sorğulara hər hansı mənbədən icazə verilir. Preflight OPTIONS sorğuları dəstəklənir.

İstifadə və məhdudiyyətlər

Hər çevirmə API açarı üzrə sayılır. İdarə panelinizd ə ümumi istifadəni və son 7 və 30 gün ərzində istifadəni görə bilərsiniz. Daxili sürət məhdudiyyətləri yoxdur; server yükləmə və resurs məhdudiyyətləri tətbiq oluna bilər.

Dəstəklənən formatlar

Giriş: PDF, JPG, JPEG, PNG, TIFF, WebP.

Çıxış: Həmişə PDF (skan edilmiş görünüşlə).