API - Form - POST form/submission/{id}
POST form/submission/{id}
Verwendet für
Serverseitiges "Einreichen" einer Formular-Einsendung aus einer externen Anwendung.
Die Einsendung durchläuft dieselbe Verarbeitung wie eine Einsendung über das Web: Verknüpfung mit einem bestehenden Kunden auf Basis der E-Mail-Adresse sowie den Versand der eingestellten Bestätigungs- und Administrator-Benachrichtigungs-E-Mails.
Das Speichern erfolgt bewusst "lose": unbekannte Felder werden gespeichert, die Formular-Definition wird nicht streng erzwungen. Verfügt das Formular über ein E-Mail-Feld, so wird das Format des Wertes geprüft.
Authentifizierung
Der Benutzer muss auf Administratorebene angemeldet sein und über die Berechtigung api_form_submission verfügen. Das Formular muss zur authentifizierten Lizenz gehören.
Parameter
| Parameter | Beschreibung | Erforderlich | Beispiel |
|---|---|---|---|
| id | ID des Formulars (in der URL) | Ja | 12 |
| <veldnaam> | Pro Feld ein Schlüssel/Wert-Paar. Die Feldnamen sind die field_name-Werte aus GET form/{id}. |
Abhängig vom Formular | email = jan@voorbeeld.nl |
Beispiel
Ein Kontaktformular (id 12) mit Name, E-Mail und Nachricht einreichen.
POST api/rest/form/submission/12
Request:
{
"name": "Jan Jansen",
"email": "jan@voorbeeld.nl",
"message": "Graag meer informatie."
}
Response:
{
"result": true,
"message": "submission saved",
"submission_id": 345,
"status": 10
}
