API Endpoints
US Node – https://www.taskform.nl:443/api/v2/screen/form
EU Node – https://dashboard.taskform.io:443/api/v2/screen/form
US Node – https://dashboard.taskform.nl:443/api/v2/screen/form
The Screen Form API returns the Form Screen matching the given parameters.
On our Cloud service, this API is available via SSL-secured HTTPS connection using the REST GET, POST, PUT and DELETE verbs.
To search for and retrieve the published version of a Screen, use a GET with the screen API found at:
CONTENTS
-
GET Request
-
GET Response
-
API Usage Example
GET Request
The GET verb allows you to return configuration details of the specified form ID.
The required parameters for a GET call to the Screen API are outlined below.
When logged into an account, Ids can be found on the Organisation Setup > Integrations page of the secure website.
After clicking “Try it out!” the GET Request URL will display for integration use in your systems.
Also, the Response Body, Code and Headers will be visible.
GET Response
The data returned from a Screen GET is provided as follows:
API Usage Example
Given that the API is REST-based, you can access the API directly via your web browser to test it. Obviously, for actual integration works, you will need to make a web request to the given REST URL and then parse the response.
When integrating with your system, the format query string parameter controls the desired response format. Specify either XML or JSON.
/api/v2/screen/form?format=xml/json
Below are simple GET examples which get a Screen/Screens returned from the endpoint..
GET Request URL
https://dashboard.taskform.io:443/api/v2/screen/form?CompanyId=6XXXX&IntegrationKey=995dfXXXXXXXXXXXXXXXXXXXXXXXXXXX&Id=9d324XXXXXXXXXXXXXXXXXXXXXXXXXXX
GET Request URL (XML)
https://dashboard.taskform.io:443/api/v2/screen/form?format=xml&CompanyId=6XXXX&IntegrationKey=995dfXXXXXXXXXXXXXXXXXXXXXXXXXXX&Id=9d324XXXXXXXXXXXXXXXXXXXXXXXXXXX
GET Request URL (JSON)
https://dashboard.taskform.io:443/api/v2/screen/form?format=json&CompanyId=6XXXX&IntegrationKey=995dfXXXXXXXXXXXXXXXXXXXXXXXXXXX&Id=9d324XXXXXXXXXXXXXXXXXXXXXXXXXXX