← PDFtoSCAN Autentificare / Obțineți cheie API

Documentație API

Folosiți conversia PDFtoSCAN din aplicațiile dvs. Toate cererile API necesită o cheie API (obțineți una după înregistrare).

URL de bază

Toate punctele finale sunt relative la:

https://pdftoscan.com/api/v1

Autentificare

Includeți cheia dvs. API în fiecare cerere folosind una dintre aceste metode:

Header Antet X-API-Key: cheia-dvs-api
Header Antet Authorization: Bearer cheia-dvs-api

Pentru a obține o cheie API: înregistrare, apoi în Tablou de bord dvs. generați o cheie nouă. Cheia este afișată o singură dată—păstrați-o în siguranță.

Convertiți în aspect scanat

POST /convert.php

Încărcați un PDF sau o imagine, sau trimiteți un URL de fișier, și primiți un PDF cu aspect scanat (înclinare, zgomot, fundal murdar opțional, A4 opțional).

Cerere

Metodă: POST
Content-Type: multipart/form-data (sau application/x-www-form-urlencoded când folosiți doar file_url puteți folosi application/x-www-form-urlencoded)

Parametri

Parametru	Tip	Necesar	Descriere
`file` sau `pdf`	file	Nu	Fișier PDF, JPG, PNG, TIFF sau WebP de convertit (încărcare). Folosiți file sau file_url.
`file_url`	string	Nu	URL HTTP(S) al unui PDF sau imagine de convertit. Folosiți încărcarea fișierului sau file_url (max. 50 MB, timeout 30 s).
`color_mode`	string	Nu	color sau bw. Implicit: bw (alb-negru).
`rotate`	number	Nu	Înclinarea paginii în grade (-1.5 până la 1.5). Implicit: 0.
`noise`	number	Nu	Cantitate zgomot 0–1. Implicit: 0.1 (10%).
`dirty_background`	string	Nu	1 (implicit) pentru a arăta margini negre murdare, 0 pentru a dezactiva.
`force_a4`	string	Nu	1 (implicit) pentru a ajusta ieșirea la A4, 0 pentru a păstra dimensiunea originală.

Răspuns

Succes (200): Corpul răspunsului este fișierul PDF. Salvați sau transmiteți conținutul binar.

Eroare (4xx/5xx): Corp JSON: {"ok": false, "error": "Mesaj eroare"}

Coduri de stare

Code	Semnificație
200	Succes — răspunsul este PDF-ul.
400	Cerere incorectă — fișier lipsă, format greșit sau eroare de încărcare.
401	Neautorizat — cheie API lipsă sau invalidă.
405	Metodă nepermisă — folosiți POST.
500	Eroare server — conversie eșuată.
503	Serviciu indisponibil — conversie indisponibilă pe server.

Exemple

cURL

Încărcați un fișier:

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

Sau trimiteți un URL de fișier:

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

Cererile din browsere sunt permise din orice origine. Cererile OPTIONS preflight sunt acceptate.

Utilizare și limite

Fiecare conversie este numărată pe cheie API. În tabloul de bord puteți vedea utilizarea totală și utilizarea din ultimele 7 și 30 de zile. Nu există limite de rată încorporate; pot fi aplicate limitele de încărcare și resurse ale serverului.

Formate acceptate

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

Ieșire: Întotdeauna PDF (cu aspect scanat).