Formularportal

Individuelle Formulare per SMS an Empfänger senden – mit automatischer Speicherung, E-Mail-Zustellung und Webhook-Weiterleitung.

Das Formularportal ermöglicht es, individuelle Formulare per SMS an Empfänger zu senden. Der Empfänger erhält einen Link, füllt das Formular aus und die Antworten werden gespeichert, per E-Mail zugestellt und/oder per Webhook weitergeleitet.

Basis-URL: https://api.anolink.de

Authentifizierung

Alle API-Aufrufe erfordern zwei Pflichtfelder im JSON-Body:

Feld	Beschreibung
`token`	API-Token der Organisation (min. 8 Zeichen)
`orgId`	Organisations-UUID

Beide Werte sind auf der Konfigurationsseite (/api-konfiguration) einsehbar. Das Token wird beim Erstellen in der Datenbank gespeichert. Wird ein neues Token erzeugt, wird das alte ungültig (Upsert-Verhalten).

Formular-Ablauf (End-to-End)

1. API-Call: POST /api/portal/request
   → SMS mit Formular-Link an Empfänger
          ↓
2. Empfänger öffnet /f (oder /f?o=shortcode)
   → Eingabe: Vorgangsnummer + Handynummer
          ↓
3. Authentifizierung
   → 2FA aktiviert: OTP per SMS → Code eingeben
   → 2FA deaktiviert: Direkt weiter zum Formular
          ↓
4. Formular ausfüllen unter /f/&#123;rnummer&#125;
   → Alle Feldtypen werden gerendert
   → Dateien können hochgeladen werden
   → Pflichtfelder werden client-seitig validiert
          ↓
5. Formular absenden
   → Server-Validierung
   → Speicherung in form_submissions
   → E-Mail mit Anhängen (wenn konfiguriert)
   → Webhook (wenn URL gesetzt)
   → Status → "completed"
          ↓
6. Redirect
   → portal_redirect_url (wenn gesetzt) ODER /f/done

Inhaltsverzeichnis

API-Aufruf – Der Haupt-API-Endpunkt
E-Mail-Zustellung – Ergebnis per E-Mail erhalten
Webhook – Externe Systeme benachrichtigen
Feldtypen – Verfügbare Formularfeld-Typen
Konfiguration – Einstellungen in der Web-App
Dashboard – Seiten und interne Endpunkte

Endpunkte-Übersicht API-Aufruf