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:

  1. API-Token im Dashboard erzeugen
  2. Session erstellen (POST /api/embed/sessions) mit Token + orgId
  3. 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:

  1. API-Aufruf: POST /api/portal/request – sendet SMS mit Portal-Link
  2. Empfänger öffnet Link, gibt R-Nummer und Handynummer ein
  3. OTP-Bestätigung per SMS (falls 2FA aktiviert)
  4. 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.