Webhooks ermöglichen anderen Systemen, über eine einfache technische Schnittstelle Dokumente zu empfangen und dort weiter zu verwenden.
Voraussetzungen
Für die Verwendung für Webhooks benötigen Sie einen Web-Server, der die von uns gemachten Anfragen laut der folgenden Spezifikation verarbeiten kann:
Der Upload erfolgt ausschließlich über HTTPS.
Jeder Scan wird via POST-Anfrage als multipart/form-data Payload mit zwei Teilen geliefert: Die Binärdatei 'document' und einen 'meta'-Teil, der sendungsrelevante Daten (JSON) enthält.
Als Antwort wird ein 20X-Status erwartet. Der Content-Type wird nicht geprüft.
Beispiel für eine angedeutete Anfrage:
--DropscanBoundary
Content-Disposition: form-data; name="metadata"; filename="metadata.json" Content-Length: 15
Content-Type: application/json
Content-Transfer-Encoding: binary {"uuid":"de5ebcea-e509-44a8-b7e1-c429f4f75b1e", scanbox_id: 1234, scanned_at: }
--DropscanBoundary
Content-Disposition: form-data; name="document"; filename="scan.pdf"
Content-Length: 754771
Content-Type: application/pdf
Content-Transfer-Encoding: binary %PDF-1.5 [...]
--DropscanBoundary—
Einrichtungsschritte bei Dropscan
- Melden Sie Sich bei Ihrem Dropscan-Konto an. Dort klicken Sie oben rechts auf Ihre E-Mail-Adresse und dann auf Einstellungen.
- Wählen Sie Webhook unter dem Menüpunkt Integrationen aus.
- Tragen Sie die Webhook-URL ein, an die wir die Dokumente versenden sollen.
- Klicken Sie auf Einrichten.
Zur Bestätigung der erfolgreichen Einrichtung senden wir ein erstes Test-Dokument. Sollte es Probleme bei der Einrichtung geben, werden Sie natürlich von uns informiert.
Nächste Schritte
Die Integration stellt nur die Verbindung zu Ihrem Webhook-Server her. Für das Teilen von gescannten Dokumenten mit dieser Integration haben Sie zwei Möglichkeiten:
- Dokumente manuell teilen
- Dokumente automatisch teilen mit einem Workflow
Informationen dazu finden Sie hier.
