Formular absenden

Formulardaten per API einreichen – automatisch oder direkt.

Wird automatisch vom eingebetteten Formular aufgerufen. Kann auch direkt per API genutzt werden, z.B. für eigene Frontends.

Endpunkt

POST /api/embed/submit

Request-Body (mit Session)

{
  "sessionId": "a1b2c3d4-...",
  "values": {
    "vorname": "Max",
    "nachname": "Mustermann",
    "email": "max@beispiel.de",
    "anliegen": "allgemein",
    "nachricht": "Ich hätte eine Frage...",
    "datenschutz": true,
    "anhang": [
      {
        "name": "beleg.pdf",
        "path": "org-id/template/anhang/abc.pdf",
        "url": "https://...signedUrl...",
        "size": 245000,
        "type": "application/pdf"
      }
    ]
  },
  "rnummer": "auftrag-456",
  "phone": "+491701234567"
}

Alternativ mit Token (ohne Session)

{
  "token": "sk_dev_abc123...",
  "orgId": "550e8400-...",
  "templateIdentifier": "anoXYZ1234",
  "values": { "..." : "..." }
}

Feld	Typ	Pflicht	Beschreibung
`sessionId`	`string`	Ja*	Session-ID (alternativ: `token` + `orgId`)
`values`	`object`	Ja	Objekt mit Feldwerten
`rnummer`	`string`	Nein	Eigene Kennung
`phone`	`string`	Nein	Telefonnummer

Erfolgs-Antwort (200)

{
  "ok": true,
  "rnummer": "auftrag-456",
  "webhookDelivered": true
}

Serverseitiger Ablauf

Pflichtfelder werden validiert (basierend auf dem Schema der Vorlage)
Submission wird in der Datenbank gespeichert
Bestehender Draft wird automatisch gelöscht
Webhook wird gesendet (falls konfiguriert)
Audit-Log wird geschrieben
Redirect wird im Formular ausgeführt (falls konfiguriert)
E-Mail wird versendet (falls konfiguriert)

Validierungsfehler (400)

{
  "error": "Validation failed",
  "fieldErrors": [
    { "key": "email", "message": "Pflichtfeld" },
    { "key": "datenschutz", "message": "Pflichtfeld" }
  ]
}

Template laden Zwischenspeicherung