Zwischenspeicherung (Drafts)

Formulareingaben werden automatisch zwischengespeichert. Der Nutzer kann das Formular schließen und später mit demselben draftKey weitermachen.

Aktivierung: draftKey in der Session-Config oder als URL-Parameter setzen.

Verhalten:

• Änderungen werden alle 1,5 Sekunden automatisch gespeichert
• Leere Formulare werden nicht gespeichert
• Neue Werte werden mit bestehenden zusammengeführt (nie überschrieben)
• Nach dem Absenden wird der Draft automatisch gelöscht

Draft speichern

POST /api/embed/drafts

{
  "sessionId": "a1b2c3d4-...",
  "draftKey": "kunde-789",
  "values": { "vorname": "Max" }
}

Alternativ mit token + orgId + templateIdentifier statt sessionId.

Antwort (200)

{
  "ok": true,
  "draftKey": "kunde-789",
  "savedAt": "2026-02-23T14:30:00Z"
}

Werte werden mit bestehenden zusammengeführt. Beispiel: Gespeichert ist { "vorname": "Max" }. Neuer Save mit { "email": "max@test.de" }. Ergebnis: { "vorname": "Max", "email": "max@test.de" }.

Draft laden

GET /api/embed/drafts?sessionId=<id>&draftKey=<key>

Oder:

GET /api/embed/drafts?token=<token>&orgId=<org>&templateIdentifier=<id>&draftKey=<key>

Antwort (200) – Draft vorhanden

{
  "ok": true,
  "draft": {
    "id": "uuid",
    "draftKey": "kunde-789",
    "templateIdentifier": "anoXYZ1234",
    "values": { "vorname": "Max", "email": "max@test.de" },
    "updatedAt": "2026-02-23T14:30:00Z"
  }
}

Antwort – kein Draft vorhanden

{ "ok": true, "draft": null }

Draft löschen

DELETE /api/embed/drafts

{
  "sessionId": "a1b2c3d4-...",
  "draftKey": "kunde-789"
}

Antwort (200)

{ "ok": true }