Zum Hauptinhalt springen

Nächstes Tool finden

DashboardAndroid-App
Sprache
Darstellung
Entwickler-API und Automatisierung

Dokumentautomatisierung auf Basis von MAXScanner

Eine REST-API für Dokumentkonvertierung, Zusammenführen und OCR – mit vollwertiger Unterstützung für Zapier, Make und n8n. Kostenlos starten, ohne Kreditkarte.

Schnellstart

  1. Melde dich an und öffne dein Dashboard, dann API & Automatisierung → API-Schlüssel → Neuen Schlüssel erstellen.
  2. Kopiere den Schlüssel (er wird nur einmal angezeigt) – er sieht so aus: mxs_xxxxxxxx_xxxxxxxxxxxx.
  3. Sende ihn bei jeder Anfrage als Bearer-Token: Authorization: Bearer YOUR_API_KEY.
curl -X POST https://maxscanner.app/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
  --output report.pdf
LIVE

Teste die API sofort

Damit wird der echte Endpunkt /api/v1/sandbox/convert aufgerufen und ein kleines, spontan erzeugtes Demo-Dokument konvertiert. Kein API-Schlüssel nötig – und es funktioniert nur von dieser Seite auf maxscanner.app, kann also nicht anderswo eingebettet oder abgegriffen werden.

Nutzungslimits und kostenlose Credits

GRATIS-TARIF

10 / Tag

und 100 Anfragen pro Monat, dauerhaft kostenlos. Keine Kreditkarte nötig.

BEZAHLTARIFE

2.000 – unbegrenzt

Starter (2.000 Credits/Monat), Pro (10.000/Monat), Business (unbegrenzt).

Bezahltarife verbrauchen Credits pro Vorgang:

Konvertieren — 2 CreditsZusammenführen — 1 CreditOCR — 3 CreditsNutzungsabfrage — kostenlos

Endpunkte

Basis-URL: https://maxscanner.app/api/v1

GET/healthkostenlos, ohne Schlüssel

Prüft, ob die API erreichbar ist – nützlich für den Schritt „Verbindung testen“ in Zapier.

ANTWORT

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usagekostenlos

Zeigt deinen aktuellen Tarif und das verbleibende Kontingent für den gesendeten Schlüssel.

ANTWORT

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 Credits

Konvertiert ein Dokument unter einer URL in ein anderes Format (pdf, docx, xlsx, pptx, txt, html, png, ...).

ANFRAGETEXT

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

ANTWORT

Binärdatei (Content-Type entspricht dem angeforderten Format)
POST/merge1 Credit

Führt 2–20 PDFs (als URLs angegeben) in der angegebenen Reihenfolge zu einem PDF zusammen.

ANFRAGETEXT

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

ANTWORT

Binärdatei (application/pdf)
POST/ocr3 Credits

Extrahiert Text aus einem gescannten Bild oder PDF per echter OCR – auch ganz ohne Textebene.

ANFRAGETEXT

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

ANTWORT

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 Credit

Legt aus einer Automatisierung eine Datei IN deiner MAXScanner-Bibliothek ab – die Gegenrichtung zu /convert.

ANFRAGETEXT

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

ANTWORT

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribekostenlos

Registriert eine Webhook-URL für künftige Ereignisse eines Typs. Siehe „Webhooks, Zapier & n8n“ weiter unten.

ANFRAGETEXT

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

ANTWORT

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribekostenlos

Entfernt ein Webhook-Abonnement anhand seiner id.

ANFRAGETEXT

{ "id": "..." }

ANTWORT

{ "success": true }
GET/hookskostenlos

Listet deine aktiven Webhook-Abonnements mit dem Status der jeweils letzten Zustellung auf.

ANTWORT

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

/convert UNTERSTÜTZT (NICHT NUR OFFICE-FORMATE)

Word / Excel / PowerPointPDFder Klassiker „Office zu PDF“
PDFWord / Nur-Text / HTML„PDF zu Office“
PDFPNG-/JPG-Bildein Bild pro Seite
PNG-/JPG-BildPDFmacht aus einem Bild eine PDF-Seite

Zapier, Make, n8n & Webhooks

Verbinde die MAXScanner-Android-App mit über 5.000 Apps. Öffne in der App Einstellungen → Zapier & Automatisierung (oder die Kachel API & Automatisierung unter Werkzeuge), um ein Abo abzuschließen und deinen Integrationsschlüssel zu erhalten. Nutze ihn dann im Verbindungsschritt von Zapier als MAXScanner-API-Schlüssel – derselbe Schlüssel funktioniert auch für die direkten REST-Aufrufe oben.

VERFÜGBARE AUSLÖSER

Neues gescanntes Dokumentscan.createdAlle Tarife

Wird ausgelöst, sobald in der App ein neues Dokument gescannt wird.

Neuer PDF-Exportpdf.exportedAlle Tarife

Wird ausgelöst, wenn eine Dokumentgruppe als PDF exportiert wird.

Neuer Scan mit Standortgeotag.capturedPro und höher

Wird für Scans mit Standortdaten (Adresse, Stadt, Koordinaten) ausgelöst.

Neue Aufnahme mit Zeitstempeltimestamp.capturedBusiness

Wird für Aufnahmen mit Zeitstempel ausgelöst.

Neuer OCR-Text extrahiertocr.completedPro und höher

Wird ausgelöst, wenn der OCR-Text auf dem Gerät für einen Scan verfügbar ist.

Neuer QR-Code gescanntqr.scannedAlle Tarife

Wird ausgelöst, sobald in der App ein QR-Code gescannt wird – mit dem dekodierten Text.

Make.com

Visuelle Automatisierungsszenarien

n8n

Selbst gehostete Workflow-Automatisierung

Webhooks

Direkte HTTP-Callbacks für alles andere

Alle drei Plattformen funktionieren hier gleich: Sie geben dir eine URL, und du lässt MAXScanner per /hooks/subscribe dorthin POSTen. Eine native Zapier-App gibt es noch nicht – genutzt wird die generische Zapier-Aktion Webhooks by Zapier, die schon heute funktioniert.

⚡ Zapier Schritt für Schritt

  1. Erstelle einen Zap → suche die App Webhooks by Zapier → wähle das Auslöserereignis Catch Hook.
  2. Zapier zeigt dir eine eigene Webhook-URL (z. B. https://hooks.zapier.com/hooks/catch/...). Kopiere sie.
  3. Rufe einmal /hooks/subscribe von MAXScanner mit dieser URL und dem gewünschten Ereignis auf (siehe curl-Beispiel unten).
  4. Löse zurück in Zapier ein Testereignis in der App aus (z. B. ein Dokument scannen) – der Schritt Catch Hook sollte Beispieldaten zeigen. Baue von dort aus die Aktion deines Zaps weiter (Google Drive, Sheets, Slack, E-Mail, beliebig).

🔄 n8n Schritt für Schritt

  1. Füge einem neuen Workflow einen Webhook-Auslöserknoten hinzu. Stelle ihn so ein, dass er POST-Anfragen annimmt.
  2. Kopiere die Production URL des Knotens (aktiviere den Workflow vorher, damit er live ist).
  3. Rufe /hooks/subscribe mit dieser URL und dem gewählten Ereignis auf.
  4. Löse in der App ein Testereignis aus – der Webhook-Knoten empfängt die Nutzdaten, bereit für den Rest deines Workflows.

Per curl abonnieren

curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'

Bereit, deine Dokumente zu automatisieren?

Erstelle einen kostenlosen API-Schlüssel – 10 Anfragen pro Tag, 100 pro Monat, ohne Karte.