Zum Hauptinhalt springen

Nächstes Tool finden

Dokumentation/Automatisierung/Make (Integromat): MaxScanner-Szenarien
Automatisierung

Make (Integromat): MaxScanner-Szenarien

Nutzen Sie die HTTP- und Webhooks-Module von Make, um in jedem beliebigen Szenario Dateien mit MaxScanner zu konvertieren, zu komprimieren und per OCR zu verarbeiten.

Kurze Antwort

Fügen Sie in Make das HTTP-Modul „Make a request“ mit der Methode POST, der URL https://maxscanner.app/api/v1/jobs/, einem Header Authorization: Bearer <key>, dem Body-Typ Raw und dem Content-Type JSON hinzu. Speichern Sie den Schlüssel in einer Make-Verbindung oder einem Data Store, nicht im Klartext in Modulfeldern, die andere sehen können. Für die Benachrichtigung über den Abschluss erstellen Sie ein Szenario mit Webhooks „Custom webhook“ und abonnieren mit dessen URL processing.completed.

Schnellstart

  1. 1Erstellen Sie einen MaxScanner-API-Schlüssel namens „Make“.
  2. 2Fügen Sie HTTP → Make a request hinzu: POST https://maxscanner.app/api/v1/jobs/, Header Authorization und Idempotency-Key, JSON-Body mit url, filename, format. Aktivieren Sie „Parse response“.
  3. 3Erstellen Sie ein separates Szenario, das mit Webhooks → Custom webhook beginnt, und kopieren Sie die Webhook-Adresse.
  4. 4Abonnieren Sie mit dieser Adresse einmalig per POST /api/v1/hooks/subscribe/ (Event processing.completed).
  5. 5Fügen Sie im Webhook-Szenario HTTP → Make a request hinzu: GET {{data.statusUrl}} mit dem Header Authorization, und übergeben Sie dann output.downloadUrl an das nächste Modul.

Request-Body

Ordnen Sie Idempotency-Key einen Wert zu, der pro Element eindeutig ist, etwa die Datensatz-ID des Bundles, damit ein erneut gestartetes, fehlgeschlagenes Szenario keine doppelten Jobs erzeugt.

{
  "url": "{{1.attachment.url}}",
  "filename": "{{1.attachment.name}}",
  "format": "pdf"
}

Polling innerhalb eines Szenarios

Wenn ein Webhook nicht infrage kommt, fügen Sie ein Sleep-Modul (5–10 Sekunden) und einen Repeater mit einem Router hinzu, der stoppt, sobald status completed oder failed ist. Das verbraucht mehr Operationen und MaxScanner-Anfragen als das Webhook-Muster und eignet sich daher nur für geringe Volumen.

Fehlerbehandlung

Hängen Sie einen Error-Handler an das HTTP-Modul: Break mit automatischen Wiederholungen für 429- und 5xx-Antworten sowie Ignore oder Rollback für 4xx-Antworten, die eine Korrektur erfordern. Make zeigt den MaxScanner-Fehlercode in der Modulausgabe an.

Häufige Fragen

Kann ich die Datei statt einer URL als Binärdaten senden?

Ja: Rufen Sie /extension/upload/ auf, um eine signierte URL zu erhalten, senden Sie die Binärdaten mit einem zweiten HTTP-Modul per PUT und verwenden Sie dann den zurückgegebenen objectKey als sourceKey.

Verwandte Anleitungen