Process: POST /http/processsubmission

This HTTP method captures data submitted from a form and processes the form submission, then redirects the user back to the pageURL specified in the last getCommands() call via a 303 Redirect. It updates the form session data, executes form validation, and if found to be valid processes any actions and determines the next page to render, if any. A publicly accessible URL to this method is set as the handlerURL in getCommands.

Commands may be generated by the /http/processsubmission endpoint to be returned later by a subsequent call to getCommands(). As an example of command generation, if after performing control processing it determines that a next page should be displayed a RENDER command will be generated for that page. This will be returned in a subsequent getCommands() call, ultimately displaying the next form page on the site.

Form submissions are protected by a nonce value linked to the form session that ensures a form page may only be submitted once. The handlerURL passed in as an argument to getCommands() automatically has the pageSessionId, sessionId, and nonce value appended to it, ensuring the form action URL references the latest nonce value. If the nonce is wrong or has already been used the user will be redirected to the errorPageURL rather than the pageURL.

Parameters