qlik-saas-api
v0.18.4
Published
Interact with Qlik Sense SaaS REST API
Downloads
66
Readme
Qlik Sense SaaS REST API
Node.js module to interact with Qlik Sense SaaS API
UNDER DEVELOPMENT
NOT AFFILIATED WITH QLIK
Installation
npm install qlik-saas-api
Note Node version >= 16.0.0
Note Please open and issue if you are experiencing problems with the tabular reporting related methods - sharing tasks, report templates and report filters. The API itself is quite complicated and its hard to test and verify
Authentication
At this moment only JWT authentication is supported
Usage
Initialize the client
import { QlikSaaSApi } from "qlik-saas-api";
const saasApi = new QlikSaaSApi.client({
host: "tenant-url",
authentication: {
token: "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
},
});
List of available methods:
List of apps methods:
Details for an app:
Methods
Full list of available methods can be found here
Breaking changes
After v0.10.0
Prior v0.10.0
some methods were expecting named parameters and some were expecting the arguments to be an object. From v0.10.0
onwards all public methods will expect their arguments to be an object.
Old:
async get(id: string) { ... }
New:
async get(arg: { id: string }) { ... }
The new way of calling these methods will be:
await something.get({ id: "some-id here" })
Instead of:
await something.get("some-id here")
In the future v2.0
Breaking changes will be introduced in the future v2+ of the package
All methods that require arguments will expect the arguments to be passed as an object
Current:
let updateResponse = await app.addToSpace("space-id-here");
New:
let updateResponse = await app.addToSpace({ spaceId: "space-id-here" });
There are two reasons for that:
- consistency - the other Qlik REST API packages (Repository, Proxy etc.) are using the same approach
- easier to use this package as part of Automatical and Automatical-CLI
At the moment some methods are returning the details instead of the instance. Code review will be performed and for these methods the return will be changed to class instance
Note In order to avoid usage issues the package will be released in two versions - v1+ and v2+. All new features, fixes, patches etc will be applied to both versions. v2+ will be the default version and v1+ will be installed with:
npm install qlik-saas-api@v1
Rate limit
From 01/11/2022 Qlik is introducing rate limits when using SaaS REST API. If the response is with status 429 then the rate limit is reached and the script have to wait before continue.
(from community.qlik) | Tier | Limit | Description | | ------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | Tier 1 | 600+ per minute | Supports majority of requests for data consumption with generous bursting. | | Tier 2 | 60+ per minute | Create, update, and delete resource endpoints with occasional bursts of more requests. | | Special | Varies | Rate limiting conditions are unique for methods with this tier. Consult the method's documentation to better understand its rate limiting conditions. |
For more information please check these links: