API-Aufruf
Der einzige API-Endpunkt des Formularportals: POST /api/portal/request
Es gibt genau einen API-Endpunkt:
POST https://api.anolink.de/api/portal/requestErstellt einen neuen Formularvorgang und sendet eine SMS mit dem Link an den Empfänger.
Parameter
| Feld | Pflicht | Beschreibung |
|---|---|---|
token | Ja | API-Token der Organisation |
orgId | Ja | Organisations-UUID |
phone | Ja | Mobilnummer (z.B. +4915201234567) |
rnummer | Ja | Eigene Kennung / Vorgangsnummer (2–64 Zeichen) |
templateIdentifier | Nein | Formularvorlagen-ID (z.B. anoJR5NXRC) |
from | Nein | SMS-Absendername (1–32 Zeichen) |
emailTo | Nein | E-Mail-Empfänger (String oder Array) |
emailSubject | Nein | Eigener E-Mail-Betreff (max. 200 Zeichen) |
Beispiel
curl -X POST https://api.anolink.de/api/portal/request \
-H "Content-Type: application/json" \
-d '{
"token": "ak_f26fe772a4cff5d77...",
"orgId": "020899a9-3c1a-4afd-b428-c0f31e1e144c",
"phone": "+4915201234567",
"rnummer": "AUFTRAG-456",
"templateIdentifier": "anoJR5NXRC",
"emailTo": "ergebnis@meinefirma.de",
"emailSubject": "Formularergebnis für Auftrag 456"
}'Erfolgs-Antwort (200)
{
"ok": true,
"rnummer": "AUFTRAG-456",
"phone": "+4915201234567",
"templateIdentifier": "anoJR5NXRC"
}Fehlerfälle
| Code | Bedeutung |
|---|---|
| 400 | Ungültige Handynummer oder fehlende Pflichtfelder |
| 401 | Token ungültig oder passt nicht zur orgId |
| 403 | Formularvorlage gehört nicht zur Organisation |
| 404 | Kein Formular zugeordnet oder Vorlage nicht aktiv |
| 500 | Interner Serverfehler |
Was passiert
- SMS mit Portal-Link wird an die Handynummer gesendet
- Empfänger öffnet den Link
- Gibt Vorgangsnummer + Handynummer ein
- Bekommt OTP per SMS (falls 2FA aktiv)
- Füllt das Formular aus und sendet ab
- Ergebnis wird gespeichert + E-Mail + Webhook (falls konfiguriert)