The REST field type enables you to issue a REST request in JSON or XML to an external web service and pull data from any API. The result of the request is stored in the REST field, and you can then access the result’s values through our existing JSONVAL() and XMLVAL() formula functions.
Configuring your REST Field
Drag and drop the REST field from the left-hand toolbar onto your Form page, then configure it using the right-hand properties panel.
Rest Request
Provide the details of the REST web service request the app should issue.
- Destination URL
This can be built up using our formula builder. - REST Verb
GET, POST, PUT or DELETE - REST Format
REST services support default JSON and XML formats for input and output data. The default format is JSON. - Request Body
Specify an optional payload in JSON or XML (depending on the format selected). Use our standard Data Template syntax to inject field values and formula results.
e.g.
{
'MyJsonProperty': '{{myfieldvalue}}'
}
Request Headers
Specify optional headers to be sent with the request. Use our standard Data Template syntax to inject field values and formula results.
e.g. {{myfieldvalue}}
Values will be URL encoded.
e.g. ‘Value@#$%‘ will become ‘Value%40%23%24%25‘
Dialog Message
This displays a custom dialog message while the request is being executed.
Request Trigger
Specify when the request should be executed.
On Form Load: Triggers the request to fire once the form has loaded successfully.
On Condition: Triggers the request once the specified condition is evaluated to be true.
A REST field that is set to run ON FORM LOAD needs to be on the first page of the form.
Request Condition
Controls when to execute this request by evaluating a formula with a true/false result.
e.g., NOTBLANK({{myActionField}}) will fire this request when myActionField‘s button is pressed.
REST Weather Example App
To help you get acquainted with this field type, we’ve created an example app published in our Examples Catalog.
This example app utilizes a free account at APIXU to demonstrate how to connect to an API to pull current weather information.
This account has limitations of 10,000 API calls per month.
To make use of this API in your own solutions, use the following Steps 1-4:
- The request requires an API key, which you can acquire by signing up for your own account.
Get your own API Key on the link below:
https://www.apixu.com/signup.aspx - Next, update the hidden field, apiKey, with your key.
- Test or Publish the form
- Open the Form on your mobile device and select a country from the drop-down below.
Using the JSONVAL() formula to evaluate the response, the form populates fields with the current weather information.
Learn more about our data interchange formulas in our Formula Cheat Sheet.