← PDFtoSCAN Giriş yap / API anahtarı al

API Dokümantasyonu

Uygulamalarınızdan PDFtoSCAN dönüştürmesini kullanın. Tüm API istekleri bir API anahtarı gerektirir (kayıt sonrası alın).

Temel URL

Tüm uç noktalar şuna göredir:

https://pdftoscan.com/api/v1

Kimlik doğrulama

Her istekte API anahtarınızı bu yöntemlerden birini kullanarak ekleyin:

Header Başlık X-API-Key: api-anahtarınız
Header Başlık Authorization: Bearer api-anahtarınız

API anahtarı almak için: kayıt, ardından Kontrol paneli'nizde yeni bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir—güvenli bir şekilde saklayın.

Taranmış görünüme dönüştür

POST /convert.php

Bir PDF veya görsel yükleyin veya bir dosya URL'si gönderin ve taranmış görünümlü bir PDF alın (eğim, gürültü, isteğe bağlı kirli arka plan, isteğe bağlı A4).

İstek

Yöntem: POST
Content-Type: multipart/form-data (veya application/x-www-form-urlencoded yalnızca file_url kullanırken application/x-www-form-urlencoded kullanabilirsiniz)

Parametreler

Parametre	Tür	Gerekli	Açıklama
`file` veya `pdf`	file	Hayır	Dönüştürülecek PDF, JPG, PNG, TIFF veya WebP dosyası (yükleme). file veya file_url kullanın.
`file_url`	string	Hayır	Dönüştürülecek bir PDF veya görselin HTTP(S) URL'si. Dosya yükleme veya file_url kullanın (maks. 50 MB, 30 s zaman aşımı).
`color_mode`	string	Hayır	color veya bw. Varsayılan: bw (siyah beyaz).
`rotate`	number	Hayır	Derece cinsinden sayfa eğimi (-1.5 ile 1.5 arası). Varsayılan: 0.
`noise`	number	Hayır	Gürültü miktarı 0–1. Varsayılan: 0.1 (%10).
`dirty_background`	string	Hayır	1 (varsayılan) kirli siyah kenarları göstermek için, 0 devre dışı bırakmak için.
`force_a4`	string	Hayır	1 (varsayılan) çıktıyı A4'e sığdırmak için, 0 orijinal boyutu korumak için.

Yanıt

Başarılı (200): Yanıt gövdesi PDF dosyasıdır. İkili içeriği kaydedin veya akıtın.

Hata (4xx/5xx): JSON gövdesi: {"ok": false, "error": "Hata mesajı"}

Durum kodları

Code	Anlam
200	Başarılı — yanıt PDF'dir.
400	Hatalı istek — dosya eksik, yanlış format veya yükleme hatası.
401	Yetkisiz — API anahtarı eksik veya geçersiz.
405	Yönteme izin verilmiyor — POST kullanın.
500	Sunucu hatası — dönüştürme başarısız.
503	Hizmet kullanılamıyor — sunucuda dönüştürme mevcut değil.

Örnekler

cURL

Bir dosya yükleyin:

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

Veya bir dosya URL'si gönderin:

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

Tarayıcılardan gelen isteklere herhangi bir kaynaktan izin verilir. Preflight OPTIONS istekleri desteklenir.

Kullanım ve sınırlar

Her dönüştürme API anahtarı başına sayılır. Kontrol panelinizde toplam kullanımı ve son 7 ve 30 günlük kullanımı görebilirsiniz. Yerleşik hız sınırları yoktur; sunucu yükleme ve kaynak sınırları uygulanabilir.

Desteklenen formatlar

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

Çıkış: Her zaman PDF (taranmış görünümlü).