How to use Postman to make API calls and use/verify JSON output in Qlik Sense Enterprise on Windows

NadiaB — Wed, 25 Jun 2025 06:03:27 GMT

The following article describes how to use Postman to make GET and PUT requests and verify the JSON output.

Prerequisites

In this example, Postman resides outside the Qlik Sense servers, so the certificates need to be exported to make the API calls. Export the Certificates selecting "Platform independent PEM-format", the following article can be used as a reference, just make sure to select "Platform independent PEM-format" instead. Export client certificate and root certificate to make API calls
For best practices, the user utilized for this sample is not the Service Account.
It is necessary to create a new Tag in the QMC so we can later use it to add it to an existing object.
Download Postman
This exercise was implemented using Qlik Sense April 2020 (13.72.3)

Environment:

Qlik Sense Enterprise on Windows

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.

Resolution

Steps

Copy the Certificates to the server/computer where Postman is used.
Open Postman and go to menu "Settings" , In the General tab set "SSL certificate verification" to Off, In the Certificates Tab select "add Certificate" and set the path to the exported certs. The CRT file path will correspond to the path where the client.pem certificate resides, the Key file to the cleint_key.pem

Now Postman is ready to be used, this article describes how to make a GET and PUT request to add a tag to a sheet.

It is suggested to visit our Help site to verify the documentation about the API, in this case we will use

get /app/object/{id}
put /app/object/{id}

The URL would be
https://qlikserver1.domain.local:4242/qrs/app/object/aa73b22a-c933-4c26-aa2b-1e0947d708ab?xrfkey=12345678qwertyui
[Server] + [API end point] + [xrfkey]

The necessary headers would be :
X-Qlik-xrfkey = 12345678qwertyui
(this value needs to be the same provided in the URL xrfkey), for questions about xrfkey headers please refer to the following information: Using Xrfkey headers
X-Qlik-User = UserDirectory=DOMAIN;UserId=Administrator (this value would be the user to make the API calls)

Note that Postman will include xrfkey in the parameters section once the URL is pasted in the GET response.

Please refer to the following pictures to verify the configurations are correct.

GET

Postman Headers

Once is configured you can click the "Send" button, the Response will look like this:

PUT

In order to send the PUT method it is necessary to copy the JSON Response from the previous GET call and modify the necessary information, this need to be done carefully otherwise the request will return an error. The details can be found In our Qlik Site under "Updating an entry" section included here.

Sample (It will be necessary to include a comma if there are already tags associated to the object)

{ "id": "376e0283-3e5b-4968-bc55-2a19c4ba3b17", "name": "Tag3", "privileges": null }

Please refer to the following pictures to verify that the configurations are correct

PUT Header

PUT Body

Once the information is correct, select the "Send" button, and you should get a 200 OK Status.

We can verify the chances in the Qlik Sense Management Console, now the tag shows 1 Occurrence and the sheet shows the new tag.

Re: How to use Postman to make API calls and use/verify JSON output in Qlik Sense Enterprise on Windows

Nixi80 — Wed, 03 Sep 2025 08:50:37 GMT

Good Morning, I have a problem with a POST REQUEST in Qlik Sense Enterprise.
I'm trying to call an App by Python, but it's still giving me an error:
<BODY><h2>Service Unavailable</h2>
<hr><p>HTTP Error 503. The service is unavailable.</p>
</BODY></HTML>

This is the python script:

import requests

requests.packages.urllib3.disable_warnings()

# XRF key (must be 16 chars)
xrf = 'abcdefg123456789'

# Headers
headers = {
'X-Qlik-xrfkey': xrf,
'Content-Type': 'application/json',
'X-Qlik-User':'UserDirectory=DOMAIN;UserId=Administrator'

}

# Cert (PEM file or tuple of cert+key)
cert = (
r'C:\ProgramData\Qlik\Sense\Engine\Certificates\client_key - Copy.pem'
)

# Qlik Sense server
server = "https://X.X.X.X:4244"

# Task ID of the reload task you want to trigger
task_id = "192e5b76-eff6-4fff-8cd7-41cca2dbd243" # <-- replace with your task id

# QRS endpoint for starting the task
url = f"{server}/qrs/task/start/{task_id}?xrfkey={xrf}"

# Make the POST request
resp = requests.post(url, headers=headers, verify=False, cert=cert, json={})

if resp.status_code != 200:
raise Exception(f"POST /qrs/task/start {resp.status_code} -> {resp.text}")

print(f"✅ Task {task_id} started successfully!")

article How to use Postman to make API calls and use/verify JSON output in Qlik Sense Enterprise on Windows in Official Support Articles

How to use Postman to make API calls and use/verify JSON output in Qlik Sense Enterprise on Windows

Prerequisites

Environment:

Resolution

Re: How to use Postman to make API calls and use/verify JSON output in Qlik Sense Enterprise on Windows