Skip to main content
Announcements
Have questions about Qlik Connect? Join us live on April 10th, at 11 AM ET: SIGN UP NOW

How to use the Raw API Request blocks in Qlik Application Automation

No ratings
cancel
Showing results for 
Search instead for 
Did you mean: 
Emile_Koslowski
Employee
Employee

How to use the Raw API Request blocks in Qlik Application Automation

Last Update:

Jan 30, 2023 5:05:54 AM

Updated By:

Sonja_Bauernfeind

Created date:

Oct 11, 2021 10:37:23 AM

This article explains how the Raw API Request blocks in Qlik Application Automation can be used.

Most connectors in Qlik Application Automation have a Raw API Request and a Raw API List Request block that can make an API call to an API resource of your choosing. These blocks will use the connection's account & credentials.

Before using these blocks, it is advised to read the API documentation and test the call you want to make in cURL, Postman, or a similar tool.

Below is a detailed overview of these two blocks and how they should be used:

Raw API Request

 

The Raw API Request only works towards Qlik cloud services API.

Path
This block will make an API call to the connector's base URL + a path that's specified in the "Path" input parameter. For example, https://hubspot.com/api/v1/  + users. In each block implementation, the connector's base URL is hard coded.

Note: Do not specify any query parameters in the Path parameter. Use the Query Parameters input field instead.

Method
The next parameter is the method that should be used to make the request to the full URL. This can be one of the following methods: GET/POST/PUT/PATCH/DELETE

Body Parameters
The Body Parameters input field allows you to build an object of key-value pairs. This object will be converted to a JSON object and will be sent as a body parameter with the request.

Query Parameters
The Query Parameters input field will work similarly to the Body Parameters input field. Except that the final object will be transformed to a query string of the format &key1=value1?key2=value2 and URL encoding will be applied.

See the Raw API Request block of the Qlik Cloud Services connector below as an example:

 

Emile_Koslowski_2-1633963003979.png

 

 

Raw API List Request

A limitation of the Raw API Request block is that it does not implement pagination. To retrieve a list of records (that exists out of multiple pages), use the block Raw API List Request. This block has built-in paging so no manual paging with the query parameters is required.

This block will work similarly to the Raw API Request block, except for the method, which will be a GET request in all connectors.

 See the Raw API List Request block of the Qlik Cloud Services connector below as an example:

Emile_Koslowski_1-1633962888945.png

 

 

The information in this article is provided as-is and to be used at own discretion. Depending on tool(s) used, customization(s), and/or other factors ongoing support on the solution below may not be provided by Qlik Support.

 

Tags (1)
Labels (2)
Comments
igorgois_
Partner - Creator
Partner - Creator

Great tutorial!

Question: is it possible to use the data-alerts [1] or web-notifications [2]?

I am trying to get a qlik alert result and send it in a slack/teams

I only managed to use the APIs that are in the list:

Available APIs are:

Thanks in advance

[1] https://qlik.dev/apis/#rest-api-data-alerts

[2] https://qlik.dev/apis/#rest-api-web-notifications

Emile_Koslowski
Employee
Employee

Thanks for the feedback!

We are working on an update to the Raw API Request blocks, this will include data-alerts and web-notifications.

Emile

matsseverin
Partner - Contributor II
Partner - Contributor II

Hi,

Can you please show us an example of using the DELETE method in the Raw API Request block?

I have been trying to use the DELETE method of the Raw API Request block, in combination with the Qlik "Items" API, without any success. More specifically, I'm trying to delete data files in a space.

In the first step I'm using the Raw API List Request to list items (path = items) in a space with the resourceType = dataset. That gives me a list of the qvd's in that space. So far so good.

In the second step I use the Raw API request and the DELETE method, where I use the path = items/{item id}, where item id is based on the list of item ids in the first step. 

That seemingly delete the files when I look in the space, but when I go into the space settings and the Data Sources view, the files are still there? Is this a known issue or am I missing something in my automation blocks?

Thanks,

Mats

Qlik Application Automation

Emile_Koslowski
Employee
Employee

Hi Mats,

Here's an example of a DELETE method on the Items API to delete a file:

Emile_Koslowski_1-1644486379906.png

 

I get the same behavior as you when I execute the above automation, the file is removed from the catalog but still visible in the space's settings.

I'll raise this with the Items API team. But keep in mind that the DELETE endpoint of the Items API is marked as experimental, so it's best not to use it until it becomes stable.

Kind regards,
Emile

 

 

FrankGrimm
Partner - Creator
Partner - Creator

Thanks for this tutorial,

this are my first steps in application automation. 

I need to send a API Request to an external supplier. 

The needed API is:

https://{current_QCS_tenant_url}/api/{path...

The API request in the block 

RAW API REUQEST is

https://{current_qcs_tenant_url}/api/v1/{path...... 

FrankGrimm_0-1653983896809.png

 

Whats about the v1?

 

Thank you!

Frank

Emile_Koslowski
Employee
Employee

Hi Frank,

Can you share a link to the API docs of the endpoint you'd want to call here?

Emile

p_verkooijen
Partner - Specialist
Partner - Specialist

Hi @Emile_Koslowski I am trying to setup this webhook 

https://developer.teamwork.com/guides/teamwork-chat-incoming-hooks/post-data-using-incoming-hooks/

Should be quite simple, Postman works

p_verkooijen_4-1674207456329.png

 

However I keep getting an error when using it from Automations

Test url = https://chat-hooks.eu.teamwork.com/v1/in/460616/fa9b4fce-b643-4ad9-bfd8-46c8ae4083ae

p_verkooijen_3-1674207422520.png

 

 

p_verkooijen_2-1674207399186.png

What am I doing wrong?

Sonja_Bauernfeind
Digital Support
Digital Support

Hello @p_verkooijen 

Any chance you could post this over in our Automation forums to get our active engineers engaged on this (or, if this fails, a ticket may be required).

All the best,
Sonja 

Sonja_Bauernfeind
Digital Support
Digital Support

@p_verkooijen 

Thanks!

Version history
Last update:
‎2023-01-30 05:05 AM
Updated by: