Using Form Data
In a REST application, there are several common HTTP "verbs" that are used. The most common of these are the "GET" and "POST" verbs.
The best-practice assignment of when to use each verb can vary between methodologies and is beyond the scope of this documentation.
An HTTP "GET" request only passes parameters in the URL:
The "query parameters" in the above example are accessed using the
let params = request.queryParams
While the above example only refers to a GET request, the
.queryParams method applies to any HTTP request as they all can contain query parameters.
POST parameters, or params, are the standard method for passing complex data between browsers and other sources to APIs for creating or modifying content.
Perfect’s HTTP libraries make it easy to access arrays of POST params or specific params.
To return all params (Query or POST) as a
let params = request.params()
To return only POST params as a
let params = request.postParams()
To return all params with a specific name such as multiple checkboxes, type:
let params = request.postParams(name: <String>)
This returns an array of strings:
To return a specific parameter, as an optional
let param = request.param(name: <String>)
When supplying a POST parameter in the
request object is optional, it can be useful to specify a default value if one is not supplied. In this case, use the following syntax to return an optional
let param = request.param(name: <String>, defaultValue: <string>)