In conversations about the Zaloni Data Platform, the most common question we hear is “Can it integrate with product X?” which is almost immediately followed by “Can I use it without the UI?”. The answer to both is “Yes.” And it’s all made possible by the robust REST API that is built into our Platform.
Understanding API Calls Through the Command Line
For example, you may want to understand variables in the Platform Namespace. Much like environmental variables in a Linux shell, Zaloni has a Namespace used to pass variables to different parts of the product. The command line below is a great example of what this will look like.
“responseMessage”: “success”,
“restUri”: null,
“result”: {
“currentPage”: 1,
“totalRecords”: 2,
“workFlowDetails”: [
{
“category”: “unassigned”,
“createdBy”: “admin”,
“createdDate”: “11/18/2016 12:36:37”,
“modifiedBy”: “admin”,
“modifiedDate”: “11/22/2016 17:19:51”,
“wfId”: 59,
“wfName”: “Automated_Ingest_DQ_TM_noWM”
},
{
“CSVValues”: “62,Automated_Ingest_DQ_TM_TT,unassigned,admin,11/18/2016
“category”: “unassigned”,
“createdBy”: “admin”,
“createdDate”: “11/18/2016 16:22:33”,
“modifiedBy”: “admin”,
“modifiedDate”: “11/21/2016 21:46:07”,
“wfId”: 62,
“wfName”: “Automated_Ingest_DQ_TM_TT”
}
]
},
“page”: null
}
For project ID 9 (aka Trouble Tickets in this system) there are two known workflows with IDs 59 and 62.
Practicing API Calls with the Swagger UI
Most users need some assistance when using a new API. It’s really helpful to have a way to practice iterating over the creation of a correct call before putting it into your process. In the interactive Swagger documentation, that same call would look something like the diagram below:
Under the workflow page we navigate to the search API and then fill in the correct values. In this case passing just a project ID is enough. This corresponds to the concept of projects in the Zaloni Platform. These can be listed out via the “Administration” menu under “projects” or via another API call to obtain all project IDs.
RESPONSE BODY TRUNCATED:
{
“responseMessage”: “SUCCESS”,
“restUri”: “/projects”,
“result”: [
{
“projectId”: 10,
“projectName”: “Taxi Data”,
“createdBy”: “admin”,
“createdDateTime”: 1479150403000,
“canManageUserRoles”: true,
“isDefaultProject”: false,
“roleNames”: [
“Project Administrator”
]
},
{
“projectId”: 9,
“projectName”: “Trouble Tickets“,
“createdBy”: “admin”,
“createdDateTime”: 1478618016000, …
If you have applications you wish to integrate with the Zaloni Data Platform via REST API know that this is completely possible. This can be done by our staff here at Zaloni or by your staff directly. We also offer training on all aspects of the platform use including developer training. Please contact us for more information.