Skip to content

Interact with multiple Qlik Sense REST APIs from a single package

License

Notifications You must be signed in to change notification settings

Informatiqal/qlik-rest-api

Repository files navigation

Qlik Sense REST API

Interact with Qlik Sense REST APIs (Repository, Proxy, Engine and SaaS) from a single package (NodeJS/JavaScript)

mocha tests

Not affiliated with Qlik

Please check the Wiki section for details and examples


Motivation

  • communicate with multiple QS REST API services (not limited only to a single service) from single package
  • support multiple authentication mechanisms (certificates, header, JWT etc) The package itself is not performing authentication

Clients

  • Repository (QSoW)
  • Proxy (QSoW)
  • Engine (QSoW)
  • Generic (QSoW)
  • SaaS (QSoK)

Installation

npm install --save qlik-rest-api

Note Node version >= 16.0.0

Return data format

All requests are returning data in the following format:

{
    data:  {} or []    // whatever is returned (including the error(s) details if error)
    status: number     // HTTP status codes: 200, 201, 204, 404, 409 etc.
    statusText: string // HTTP status text: "OK", "Created", "Bad Request" etc.
    message: string    // optional. In case of an error this prop will be the raw message
}

Basic examples


Any "physical" content (like certificates, qvf files, extension files etc.) have to be provided in advance. The package will not read any files from the file system by itself.

Proxy API (list all active sessions)

import https from "https";
import { QlikProxyClient } from "../src/index";

const pfx = fs.readFileSync("path/to/client.pfx");

const httpsAgent = new https.Agent({
  pfx: pfx,
});

const config = {
  host: "my-sense-host",
  port: 4243,
  httpAgent: httpAgent,
  authentication: {
    user_dir: "SOME_DIR",
    user_name: "SOME_USER",
  },
};

const proxyClient = new QlikProxyClient(config);
const result = await proxyClient.Get("session");

Engine API (healthcheck of single Engine)

import https from "https";
import { QlikEngineClient } from "../src/index";

const pfx = fs.readFileSync("path/to/client.pfx");

const config = {
  host: "my-engine-host",
  port: 4747,
  httpAgent: new https.Agent({ pfx: pfx }),
  authentication: {
    user_dir: "SOME_DIR",
    user_name: "SOME_USER",
  },
};

const engineClient = new QlikProxyClient(config);
const result = await engineClient.Get("engine/healthcheck");

Repository API (list app apps with filter)

import fs from "fs";
import https from "https";
import { QlikRepositoryClient } from "qlik-rest-api";

const cert = fs.readFileSync(`path/to/client.pem`);
const key = fs.readFileSync(`path/to/client_key.pem`);

const httpsAgentCert = new https.Agent({
  rejectUnauthorized: false,
  cert: cert,
  key: key,
});

const config = {
  host: "my-sense-host.com",
  port: 4242,
  httpsAgent: httpsAgentCert,
  authentication: {
    user_dir: "SOME_DIR",
    user_name: "SOME_USER",
  },
};

const repoClient = new QlikRepositoryClient(config);

// list all apps with their name starting with "operations"
const qlikApps = await repoClient.Get(`app?filter=(name sw 'operations')`);

Methods


Developer documentation for all methods can be found here

About

Interact with multiple Qlik Sense REST APIs from a single package

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published