API-Einführung
Übersicht der anolink API – Formulareinbettung, Formularportal und digitale Signaturen.
Die anolink API ermöglicht die Integration von Formularen, Portalen und digitalen Signaturen in Ihre Systeme. Alle Endpunkte basieren auf REST-Prinzipien, akzeptieren JSON-Request-Bodies und geben JSON-Antworten zurück.
Authentifizierung
Alle API-Aufrufe erfordern einen API-Token und eine Organisations-ID (orgId). Beide werden im Request-Body übergeben und gegeneinander geprüft. Der API-Token wird im Dashboard unter „Konfiguration" erzeugt.
Der gleiche API-Token funktioniert für Formulareinbettung und Formularportal. Es muss kein separater Token erzeugt werden.
Formulareinbettung
Formulare werden per API in externe Websites eingebettet. Der Ablauf:
- API-Token im Dashboard erzeugen
- Session erstellen (
POST /api/embed/sessions) mit Token + orgId - Zurückgegebenen iframe-Code auf der Website einbinden
Der Token ist im Client nicht sichtbar – nur die Session-ID. Vorlagen definieren die Felder des Formulars und können im Dashboard oder per API verwaltet werden. Eingaben lassen sich automatisch zwischenspeichern (Drafts), und nach dem Absenden können Webhooks, E-Mails und Weiterleitungen ausgelöst werden.
→ Zur Formulareinbettung-Dokumentation
Formularportal
Das Formularportal ermöglicht es, Formulare per SMS-Link an Empfänger zu senden. Der Ablauf:
- API-Aufruf:
POST /api/portal/request– sendet SMS mit Portal-Link - Empfänger öffnet Link, gibt R-Nummer und Handynummer ein
- OTP-Bestätigung per SMS (falls 2FA aktiviert)
- Formular wird angezeigt, ausgefüllt und abgesendet
Die Ergebnisse werden gespeichert und können per E-Mail, Webhook und im Dashboard eingesehen werden. Das Portal lässt sich visuell anpassen (Layout, Branding, Support-Kontakt, Impressum).
→ Zur Formularportal-Dokumentation
Digitale Signaturen
Über die anolink API sind darüber hinaus digitale Signaturen auf drei Stufen verfügbar:
- Einfache elektronische Signatur (EES) – Für interne Prozesse und geringere Anforderungen
- Fortgeschrittene elektronische Signatur (FES) – Eindeutige Zuordnung zum Unterzeichner mit erhöhter Sicherheit
- Qualifizierte elektronische Signatur (QES) – Höchste Rechtsgültigkeit, gleichgestellt mit der handschriftlichen Unterschrift (eIDAS-konform)
Die Dokumentation für digitale Signaturen stellen wir auf Anfrage bereit. Bitte kontaktieren Sie uns unter support@anonetics.de.