Documentatie
Moeilijkheidsgraad:
API - Form - POST form/submission/{id}
POST form/submission/{id}
Gebruikt voor
Server-side "inschieten" van een formulier-inzending vanuit een externe applicatie.
De inzending doorloopt dezelfde verwerking als een inzending via het web: koppeling aan een bestaande klant op basis van het e-mailadres, en het versturen van de ingestelde bevestigings- en beheerder-notificatiemails.
Het opslaan is bewust "loos": onbekende velden worden opgeslagen, de formulier-definitie wordt niet strikt afgedwongen. Heeft het formulier een e-mailveld, dan wordt het formaat van de waarde gecontroleerd.
Authenticatie
Gebruiker dient ingelogd te zijn op beheerdersniveau en te beschikken over het recht api_form_submission. Het formulier moet bij de geauthenticeerde licentie horen.
Parameters
| Parameter | Omschrijving | Verplicht | Voorbeeld |
|---|---|---|---|
| id | ID van het formulier (in de URL) | Ja | 12 |
| <veldnaam> | Per veld een sleutel/waarde-paar. De veldnamen zijn de field_name-waarden uit GET form/{id}. |
Afhankelijk van het formulier | email = jan@voorbeeld.nl |
Voorbeeld
Een contactformulier (id 12) inschieten met naam, e-mail en bericht.
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
}
