Startseite/Dokumentation/Hosted-Scanner-Webhooks
Endpunkt-Referenz

Hosted-Scanner-Webhooks

Ein Hosted-Scanner gibt einen Link oder QR-Code an die Personen, die Dokumente scannen sollen. Ist der Scan fertig, wird das PDF an die Webhook-URL gesendet, die Sie am Scanner hinterlegt haben.

Was ScanKit sendet

Ein POST mit multipart/form-data und zwei Teilen:

  • file: der fertige Scan als PDF, Dateiname scan.pdf.
  • metadata: ein JSON-Teil mit scanner_id, scanner_name, page_count und timestamp.
http
POST https://your-app.example.com/scan-webhook
Content-Type: multipart/form-data; boundary=...

--boundary
Content-Disposition: form-data; name="file"; filename="scan.pdf"
Content-Type: application/pdf

<the finished scan as a PDF>
--boundary
Content-Disposition: form-data; name="metadata"
Content-Type: application/json

{
  "scanner_id": 4711,
  "scanner_name": "Delivery notes",
  "page_count": 2,
  "timestamp": "2026-09-19T19:41:07.512Z"
}
--boundary--
Die Nutzlast enthält keinen OCR-Text
Das Auslesen passiert danach, in Ihrem Workflow oder Ihrer Anwendung: Schicken Sie das PDF an Ihren OCR- oder Vision-Schritt, oder nutzen Sie POST /scan/scan_pdf mit ocr_lang, wenn die Textebene schon in der Datei liegen soll.

Was Ihr Empfänger leisten muss

  • Einen POST mit Multipart-Formulardaten annehmen und den file-Teil als PDF lesen.
  • Mit einem 2xx-Status antworten. Ein anderer Status wird der scannenden Person zurückgemeldet, ein langsamer oder fehlerhafter Endpunkt ist also sichtbar.
  • Die Anfrage cross-origin annehmen: Der Browser der scannenden Person sendet sie direkt an Ihre URL.
  • Eine HTTPS-URL verwenden. Eine Webhook-URL, die aus dem Internet nicht erreichbar ist, kann nichts empfangen.

Einrichtung

  • Legen Sie den Scanner im Dashboard an und geben Sie ihm einen Namen und eine Farbe.
  • Tragen Sie Ihre Webhook-URL am Scanner ein. Ohne Webhook bleibt der fertige Scan als Download bei der scannenden Person.
  • Teilen Sie den Scanner-Link oder den QR-Code, oder betten Sie die Seite auf Ihrer eigenen Website ein.
  • Am Scanner ist kein API-Schlüssel nötig: Die scannenden Personen sehen keine Zugangsdaten.
Vorlagen für n8n, Make und Zapier
Fertige Abläufe, die das PDF empfangen und in Ihrem eigenen Speicher ablegen.
Beispiele ansehen
Instant Scanner
Was ein Hosted-Scanner ist und wann ein Link besser passt als eine Integration.
Über Instant Scanner
Dokumentation