Startseite/Dokumentation/POST /scan/scan_pdf
Endpunkt-Referenz

POST /scan/scan_pdf

Ein Foto hinein, ein PDF heraus, mit Textebene, damit die Datei durchsuchbar, markierbar und archivierbar ist. Mehrere Fotos ergeben ein mehrseitiges PDF.

Anfragevertrag

POST https://api.scankit.io/scan/scan_pdf nimmt multipart/form-data an. Senden Sie file für eine einzelne Seite oder files mehrfach für ein mehrseitiges Dokument.

ParameterStandardFunktion
file oder fileserforderlichEin Bild oder mehrere Bilder für ein mehrseitiges PDF.
ocr_langengSprache der Textebene, zum Beispiel eng, deu oder fra.
  • Die Antwort ist das PDF selbst: Content-Type application/pdf, Dateiname scan.pdf, bei mehreren Seiten multipage_scan.pdf.
  • Erst begradigen, wenn Qualität zählt: Die Ausgabe von POST /scan/crop als Eingabe für diesen Endpunkt ergibt die sauberste Textebene.

Beispiele

cURL, eine Seite:

bash
curl -X POST "https://api.scankit.io/scan/scan_pdf" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@document.jpg" \
  -F "ocr_lang=eng" \
  -o scan.pdf

Python, derselbe Aufruf mit Fehlerbehandlung:

python
import requests

with open("document.jpg", "rb") as fh:
    response = requests.post(
        "https://api.scankit.io/scan/scan_pdf",
        headers={"X-API-Key": "YOUR_API_KEY"},
        files={"file": ("document.jpg", fh, "image/jpeg")},
        data={"ocr_lang": "eng"},
        timeout=120,
    )

response.raise_for_status()
with open("scan.pdf", "wb") as out:
    out.write(response.content)

Fehler

StatusBedeutungWas zu tun ist
400Keine DateiSenden Sie file für eine Seite oder files für mehrere Seiten.
401Missing API Key oder Invalid API KeyHeader X-API-Key mit einem Schlüssel aus einem aktiven Konto senden.
402Insufficient creditsCredits im Dashboard aufladen.
429Rate LimitDie in Retry-After genannten Sekunden abwarten, dann erneut senden.
500PDF generation failedDer PDF-Schritt hat für diese Eingabe kein Dokument geliefert. Einmal wiederholen, dann das Bild an den Support schicken.
Dokumentation