Hilfe Erweitert

Erweiterte Funktionen

Wenn der Standard-Ablauf steht, gibt es optionale Power-Funktionen: automatisches Erfassen per Scan, das abgesicherte Unterschreiben mit leeren Feldern, eine offene REST-Schnittstelle für eigene Software und den Assistenten Namo. Jede ist bewusst zuschaltbar — für den Alltag brauchst du keine davon. Hier ist jede erklärt.

Lesezeit ≈ 6 Min Erweiterte Funktionen Aktualisiert Jul 2026
app.aufnamo.de
Die API-Token-Verwaltung von Aufnamo
Die REST-API: Zugriffs-Tokens mit Scope und Gültigkeit für eigene Integrationen.
01

Ausweis-Scan (OCR)

Der Feldtyp „Ausweis (Scan)“ erfasst Daten direkt aus einem Foto, statt sie abtippen zu lassen — du fügst ihn im Baukasten über „Feld hinzufügen“ ein. Der Kunde fotografiert das Dokument, die Texterkennung (OCR) liest die Werte aus und die Felder werden automatisch befüllt.

1

Im Baukasten „Feld hinzufügen“ öffnen und als Typ „Ausweis (Scan)“ wählen.

2

Beim Ausfüllen fotografiert der Kunde das Dokument — die erkannten Felder werden nach dem Scan automatisch übernommen.

Ausweis (Scan)
Foto von Personalausweis oder Pass; Name, Ausweisnummer, Geburtsdatum und weitere Felder werden per OCR ausgelesen.
Visitenkarten erfasst man mit normalen Textfeldern (Name, Firma, E-Mail, Telefon) plus „Formular per Foto ausfüllen“
das liest die Karte per OCR aus und trägt die Werte ein.
Rohbild-Aufbewahrung
standardmäßig aus: das Foto wird nur ausgewertet und danach verworfen (Datenschutz). Über die Eckdaten-Option „Ausweisbild aufbewahren“ speicherst du das Rohbild pro Formular bewusst dauerhaft — dann trägst du dafür die DSGVO-Verantwortung.
Weitere Scan-Wege
Textfelder bieten zusätzlich QR-Code, Barcode, NFC-Tag und Text scannen (OCR) direkt ins Feld; mehr dazu in „Formulare & Felder“.
02

Formular per Foto ausfüllen

Ein ganzes Papier-Dokument auf einmal übernehmen, statt Feld für Feld abzutippen: Der Kunde fotografiert zum Beispiel einen Lieferschein oder ein ausgefülltes Bestellformular, die Texterkennung (OCR) liest den Text und verteilt ihn auf die passenden Felder — erkannte Anschriften landen im Adressfeld. Der Mensch prüft und bessert nach; nichts wird blind übernommen.

1

Einschalten: in den Eckdaten des Formulars den Schalter „Formular per Foto ausfüllen“ aktivieren (standardmäßig an). Erst dann erscheint der Knopf beim Ausfüllen.

2

Beim Ausfüllen tippt der Kunde oben auf „📷 Formular per Foto ausfüllen“ und wählt ein Foto — die Erkennung läuft von selbst und die passenden Felder füllen sich.

3

Prüfen und nachbessern: Das Foto bleibt mit antippbaren Textstellen sichtbar. Eine Textstelle antippen und rechts ein Feld wählen, um sie von Hand zuzuordnen.

Eine Erkennung erledigt alles
Felder werden anhand der Beschriftungs-Nähe befüllt, erkannte Anschriften wandern in die Adressfelder, und alle Textstellen werden zum Antippen aufs Foto gelegt. Es gibt keinen separaten Knopf je Aufgabe.
Bereits Ausgefülltes bleibt stehen
die automatische Erkennung füllt nur leere Felder. Von Hand oder per QR-Scan eingetragene Werte werden nie überschrieben.
Nur passende Werte
ein Datumsfeld nimmt nur ein Datum an, ein E-Mail-Feld nur eine E-Mail. Was nicht zum Feld passt, wird nicht eingetragen, sondern kurz gemeldet, statt Unsinn ins Feld zu schreiben.
Mehrere Anschriften
enthält das Foto mehr als eine Adresse (z. B. Absender und Empfänger), wählst du je Adressfeld über ein kleines Menü, welche dort hingehört.
Foto drehen
schief fotografiert? In der Bild-Vorschau lässt sich das Foto in 90°-Schritten drehen; die gedrehte Fassung wird gespeichert und mit abgeschickt.
Nur einfache Felder
Text, Auswahl, Datum, Adresse und Ähnliches. Unterschrift und Datei-Uploads bleiben außen vor. Für Ausweise gibt es den eigenen Feldtyp „Ausweis (Scan)“ (siehe oben).
03

Blanko-Modus: mit leeren Feldern unterschreiben

Manchmal muss vor Ort unterschrieben werden, obwohl einzelne Felder noch offen sind. Der Blanko-Modus macht das abgesichert möglich — mit informierter Einwilligung, manipulationssicheren Beweis-Snapshots und einer Nachtrag-Frist. Er wird bewusst je Formular aktiviert und sollte nur mit rechtlicher Sorgfalt eingesetzt werden.

1

Im Baukasten unter „Eckdaten“ den Blanko-Modus für das Formular aktivieren.

2

Bei den betreffenden Feldern die Option „Darf im Blanko-Modus leer unterschrieben werden“ setzen.

Informierte Einwilligung
der Unterzeichnende bestätigt ausdrücklich, dass Felder bewusst leer bleiben.
Beweis-Snapshots
vom leeren und vom später ausgefüllten Stand werden manipulationssichere Abbilder festgehalten.
Ausfüllfrist & Widerspruch
es gibt ein Zeitfenster zum Nachtragen und ein Widerspruchsrecht; die Details erklärt der Ratgeber-Beitrag „Blankounterschriften“.
Nicht überall sinnvoll
Felder wie Unterschrift, Produkte, Datei-Upload und Ausweis-Scan sind vom Blanko-Erlauben ausgenommen.
04

REST-API: Aufnamo mit eigener Software verbinden

Über die REST-API greift deine eigene Software programmatisch auf Formulare und Einreichungen zu — unter der Basis /api/v1. Jede Anfrage weist sich mit einem Zugriffs-Token aus (Authorization: Bearer …). So bindest du Aufnamo an dein CRM, ERP oder eigene Skripte an, ganz ohne die Weboberfläche. Die REST-API ist ab dem Business-Tarif verfügbar.

Aktueller Nutzer
/me liefert Angaben zum Konto des Tokens.
Formulare lesen
/forms listet deine Formulare, /forms/id zeigt die Details eines Formulars.
Einreichungen lesen
/forms/id/submissions listet Eingänge, /submissions/id zeigt Nutzdaten, Dateien und die ausgeführten Aktionen.
PDF & Dateien holen
/submissions/id/pdf lädt das PDF (bei Bedarf erzeugt), /submissions/id/files/file_id einen einzelnen Anhang.
Einreichung anlegen
/forms/shortcode/submissions nimmt eine Einreichung ohne Formularseite entgegen; das erfordert den Schreib-Scope.
05

API-Tokens: Scopes & Gültigkeit

Tokens (Personal Access Tokens) verwaltest du unter „API-Tokens“. Jeder Token bekommt einen Namen, einen Berechtigungsumfang (Scope) und optional eine Gültigkeitsdauer. Ein Token wird nur ein einziges Mal beim Erstellen im Klartext angezeigt — kopiere ihn sofort; geht er verloren, erstellst du einen neuen.

1

„API-Tokens → Token generieren“ öffnen und einen sprechenden Namen vergeben (z. B. „CRM-Anbindung“).

2

Den Scope wählen und optional eine Gültigkeit in Tagen setzen (leer = unbegrenzt).

3

Den angezeigten Token sofort kopieren und in deiner Software als „Authorization: Bearer …“ hinterlegen.

read
nur Lesezugriff auf Formulare und Einreichungen.
read + write
zusätzlich das Anlegen von Einreichungen über die API.
Gültigkeit (Tage)
der Token läuft nach dieser Frist automatisch ab; ohne Angabe bleibt er unbegrenzt gültig.
Prefix & Übersicht
jeder Token beginnt mit auf_pat_; die Liste zeigt Name, Prefix, Scopes, Erstellung, letzte Nutzung, Ablauf und Status.
Widerrufen
ein Token lässt sich jederzeit sofort widerrufen; danach werden Anfragen mit ihm abgewiesen.
Ein neu erstellter API-Token im Klartext
Beim Erstellen wird der Token einmalig im Klartext angezeigt — sofort kopieren.
06

API-Dokumentation zum Ausprobieren

Unter /api/docs findest du die interaktive Dokumentation aller Endpunkte, erzeugt aus der offenen Spezifikation. Du kannst Anfragen direkt im Browser testen, ohne selbst Code zu schreiben.

Interaktiv testen
oben rechts auf „Authorize“ klicken, deinen Token einsetzen und Endpunkte mit „Try it out“ live ausprobieren.
Offene Spezifikation
die maschinenlesbare Beschreibung liegt unter /api/openapi.json und lässt sich in eigene Werkzeuge importieren.
07

Hilfe-Assistent „Namo“

Namo ist der eingebaute Chat-Assistent. Er beantwortet Fragen zu Aufnamo direkt in der App und kennt dabei die Seite, auf der du dich gerade befindest — so bekommst du Antworten passend zum Kontext.

Immer zur Hand
der Assistent-Orb erscheint in der App auf allen Seiten außer den öffentlichen Formularseiten deiner Kunden.
Seiten-Kontext
Namo weiß, wo du gerade bist, und erklärt, was du auf dieser Seite tun kannst.
Kein Orb sichtbar? Dann ist der Assistent für deinen Zugang nicht freigeschaltet.
Passt dazu

Weiterlesen

FAQ

Häufige Fragen

Wird das Ausweisbild gespeichert?
Standardmäßig nein — das Foto wird nur per OCR ausgewertet und danach verworfen. Über die Eckdaten-Option „Ausweisbild aufbewahren“ kannst du das Rohbild pro Formular bewusst dauerhaft speichern; dafür trägst du dann die DSGVO-Verantwortung.
Wie oft wird mein API-Token angezeigt?
Nur ein einziges Mal — direkt beim Erstellen. Kopiere ihn sofort und hinterlege ihn sicher in deiner Software. Geht er verloren, erstellst du einen neuen und widerrufst den alten.
Was ist der Blanko-Modus?
Eine abgesicherte Möglichkeit, mit bewusst leer gelassenen Feldern zu unterschreiben — mit informierter Einwilligung, manipulationssicheren Snapshots, Ausfüllfrist und Widerspruchsrecht. Details erklärt der Ratgeber „Blankounterschriften“.
Hilfe-Center

Alle Anleitungen

Kostenlos starten

Direkt ausprobieren.

In wenigen Minuten dein erstes Formular bauen – ohne Kreditkarte, jederzeit kündbar.

Jetzt kostenlos registrieren