← PDFtoSCAN Anmelden / API-Schlüssel erhalten

API-Dokumentation

Verwenden Sie die PDFtoSCAN-Konvertierung in Ihren Anwendungen. Alle API-Anfragen erfordern einen API-Schlüssel (erhalten Sie einen nach Registrierung).

Basis-URL

Alle Endpunkte sind relativ zu:

https://pdftoscan.com/api/v1

Authentifizierung

Fügen Sie Ihren API-Schlüssel in jeder Anfrage mit einer dieser Methoden ein:

Header Header X-API-Key: ihr-api-schlüssel
Header Header Authorization: Bearer ihr-api-schlüssel

Um einen API-Schlüssel zu erhalten: Registrierung, dann in Ihrem Dashboard einen neuen Schlüssel generieren. Der Schlüssel wird nur einmal angezeigt – speichern Sie ihn sicher.

In gescanntes Aussehen konvertieren

POST /convert.php

Laden Sie ein PDF oder Bild hoch oder senden Sie eine Datei-URL und erhalten Sie ein PDF mit gescanntem Aussehen (Neigung, Rauschen, optionaler schmutziger Hintergrund, optionales A4).

Anfrage

Methode: POST
Content-Type: multipart/form-data (oder application/x-www-form-urlencoded bei Verwendung von file_url können Sie application/x-www-form-urlencoded verwenden)

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`file` oder `pdf`	file	Nein	PDF-, JPG-, PNG-, TIFF- oder WebP-Datei zum Konvertieren (Upload). Verwenden Sie entweder file oder file_url.
`file_url`	string	Nein	HTTP(S)-URL eines PDFs oder Bildes zum Konvertieren. Verwenden Sie entweder Datei-Upload oder file_url (max. 50 MB, 30 s Timeout).
`color_mode`	string	Nein	color oder bw. Standard: bw (Schwarz-weiß).
`rotate`	number	Nein	Seitenneigung in Grad (-1,5 bis 1,5). Standard: 0.
`noise`	number	Nein	Rauschstärke 0–1. Standard: 0,1 (10%).
`dirty_background`	string	Nein	1 (Standard) um schmutzige schwarze Ränder anzuzeigen, 0 zum Deaktivieren.
`force_a4`	string	Nein	1 (Standard) um Ausgabe an A4 anzupassen, 0 um Originalgröße beizubehalten.

Antwort

Erfolg (200): Antwortkörper ist die PDF-Datei. Speichern oder streamen Sie den binären Inhalt.

Fehler (4xx/5xx): JSON-Körper: {"ok": false, "error": "Fehlermeldung"}

Statuscodes

Code	Bedeutung
200	Erfolg — Antwort ist das PDF.
400	Ungültige Anfrage — fehlende Datei, falsches Format oder Upload-Fehler.
401	Nicht autorisiert — fehlender oder ungültiger API-Schlüssel.
405	Methode nicht erlaubt — verwenden Sie POST.
500	Serverfehler — Konvertierung fehlgeschlagen.
503	Service nicht verfügbar — Konvertierung auf Server nicht verfügbar.

Beispiele

cURL

Eine Datei hochladen:

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

Oder eine Datei-URL senden:

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

Anfragen von Browsern sind von jedem Ursprung erlaubt. Preflight-OPTIONS-Anfragen werden unterstützt.

Nutzung und Limits

Jede Konvertierung wird pro API-Schlüssel gezählt. In Ihrem Dashboard können Sie die Gesamtnutzung und die Nutzung der letzten 7 und 30 Tage sehen. Es gibt keine eingebauten Ratenbegrenzungen; Server-Upload- und Ressourcenlimits können gelten.

Unterstützte Formate

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

Ausgabe: Immer PDF (mit gescanntem Aussehen).