Web integrations
A web integration is a resource representing a list of whitelisted origins that can make requests to a specified tenant. It is the implementation of the CORS mechanism within Qlik Cloud.
Retrieves web integrations matching the query.
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | authenticate |
Query Parameters
- endingBeforestring
The target web integration ID to start looking before for web integrations. Cannot be used in conjunction with startingAfter.
- limitnumber
The number of web integration entries to retrieve.
- sortstring
The field to sort by. Prefix with +/- to indicate ascending/descending order.
Can be one of: "name""+name""-name"
- startingAfterstring
The target web integration ID to start looking after for web integrations. Cannot be used in conjunction with endingBefore.
- tenantIdstring
The tenant ID to filter by.
Responses
200
application/json
An array of web integration objects.
An array of web integration objects.
- application/jsonobject
An array of web integration objects.
application/json properties
- dataarray of objects
Properties of web integrations in a given tenant.
data properties
- idstring
The unique web integration identifier.
- namestring
The name of the web integration.
- createdstring
The time the web integration was created.
- tenantIdstring
The tenant that the web integration belongs to.
- createdBystring
The user that created the web integration.
- lastUpdatedstring
The time the web integration was last updated.
- validOriginsarray of strings
The origins that are allowed to make requests to the tenant.
-
- linksobject
Pagination links
links properties
- nextobject
Link information for next page.
next properties
- hrefstringRequired
URL to the next page of records.
-
- prevobject
Link information for previous page.
prev properties
- hrefstringRequired
URL to the previous page of records.
-
- selfobjectRequired
Link information for current page.
self properties
- hrefstringRequired
URL to the current page of records.
-
-
-
default
application/json
Unexpected error.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations" \
-H "Authorization: Bearer <API-key>"
const https = require('https')
const data = JSON.stringify("")
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/web-integrations',
'method': 'GET',
'headers': {
'Authorization': 'Bearer <API-key>'
}
}
const req = https.request(options)
qlik web-integration ls
Response
{
"data": [
{
"id": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"name": "string",
"created": "2018-10-30T07:06:22Z",
"tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"createdBy": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"lastUpdated": "2018-10-30T07:06:22Z",
"validOrigins": [
"string"
]
}
],
"links": {
"next": {
"href": "string"
},
"prev": {
"href": "string"
},
"self": {
"href": "string"
}
}
}
Creates a web integration.
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | authenticate |
Request Body
Requiredapplication/json
Properties that the user wants to set for the web integration.
- application/jsonobject
application/json properties
- namestringRequired
The name of the web integration to create.
- validOriginsarray of strings
The origins that are allowed to make requests to the tenant.
-
Responses
201
application/json
Web integration created successfully.
The creation of a web integration response.
- application/jsonobject
The creation of a web integration response.
application/json properties
- idstring
The unique web integration identifier.
- namestring
The name of the newly created web integration.
- linksobject
Pagination links
links properties
- selfobjectRequired
Link information for current page.
self properties
- hrefstringRequired
URL to the current page of records.
-
-
- createdstring
The time the web integration was created.
- tenantIdstring
The tenant that the web integration belongs to.
- createdBystring
The user that created the web integration.
- lastUpdatedstring
The time the web integration was last updated.
- validOriginsarray of strings
The origins that are allowed to make requests to the tenant.
-
400
application/json
Invalid request was made.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
403
application/json
Requestor not allowed to create a web integration.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations" \
-X POST \
-H "Content-type: application/json" \
-H "Authorization: Bearer <API-key>" \
-d '{"name":"My Web Integration","validOrigins":["https://thirdPartyApp.com"]}'
const https = require('https')
const data = JSON.stringify({"name":"My Web Integration","validOrigins":["https://thirdPartyApp.com"]})
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/web-integrations',
'method': 'POST',
'headers': {
'Content-type': 'application/json',
'Authorization': 'Bearer <API-key>'
}
}
const req = https.request(options)
req.write(data)
qlik web-integration create \
--name="My Web Integration" \
--validOrigins='"https://thirdPartyApp.com"'
Request
{
"name": "My Web Integration",
"validOrigins": [
"https://thirdPartyApp.com"
]
}
Response
{
"id": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"name": "My Web Integration",
"links": {
"self": {
"href": "http://mytenant.region.domain/api/v1/web-integrations/id"
}
},
"created": "2018-10-30T07:06:22Z",
"tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"createdBy": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"lastUpdated": "2018-10-30T07:06:22Z",
"validOrigins": [
"https://thirdPartyApp.com"
]
}
Retrieves a single web integration by ID.
Facts
Rate limit | Tier 1 (1000 requests per minute) |
Categories | authenticate |
Path Parameters
- idstringRequired
The ID of the web integration to retrieve.
Responses
200
application/json
Web integration found.
A web integration object.
- application/jsonobject
A web integration object.
application/json properties
- idstring
The unique web integration identifier.
- namestring
The name of the web integration.
- createdstring
The time the web integration was created.
- tenantIdstring
The tenant that the web integration belongs to.
- createdBystring
The user that created the web integration.
- lastUpdatedstring
The time the web integration was last updated.
- validOriginsarray of strings
The origins that are allowed to make requests to the tenant.
-
404
application/json
Web integration not found.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations/{id}" \
-H "Authorization: Bearer <API-key>"
const https = require('https')
const data = JSON.stringify("")
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/web-integrations/{id}',
'method': 'GET',
'headers': {
'Authorization': 'Bearer <API-key>'
}
}
const req = https.request(options)
qlik web-integration get <web-integrationId>
Response
{
"id": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"name": "string",
"created": "2018-10-30T07:06:22Z",
"tenantId": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"createdBy": "TiQ8GPVr8qI714Lp5ChAAFFaU24MJy69",
"lastUpdated": "2018-10-30T07:06:22Z",
"validOrigins": [
"string"
]
}
Updates a single web integration by ID.
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | authenticate |
Path Parameters
- idstringRequired
The ID of the web integration to update.
Request Body
Requiredapplication/json
Properties that the user wants to update for the web integration.
A JSON Patch document as defined in http://tools.ietf.org/html/rfc6902.
- application/jsonarray of objects
A JSON Patch document as defined in http://tools.ietf.org/html/rfc6902.
application/json properties
- opstringRequired
The operation to be performed.
Can be one of: "replace"
- pathstringRequired
A JSON Pointer.
Can be one of: "/name""/validOrigins"
- valuestringRequired
New value to be used for this operation.
-
Responses
204
Web integration updated successfully.
400
application/json
Invalid request was made.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
404
application/json
Web integration not found.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations/{id}" \
-X PATCH \
-H "Content-type: application/json" \
-H "Authorization: Bearer <API-key>" \
-d '[{"op":"replace","path":"/name","value":"New name"}]'
const https = require('https')
const data = JSON.stringify([{"op":"replace","path":"/name","value":"New name"}])
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/web-integrations/{id}',
'method': 'PATCH',
'headers': {
'Content-type': 'application/json',
'Authorization': 'Bearer <API-key>'
}
}
const req = https.request(options)
req.write(data)
qlik web-integration patch <web-integrationId> \
--body='[{"op":"replace","path":"/name","value":"New name"}]'
Request
[
{
"op": "replace",
"path": "/name",
"value": "New name"
}
]
Deletes a single web integration by ID.
Facts
Rate limit | Tier 2 (100 requests per minute) |
Categories | authenticate |
Path Parameters
- idstringRequired
The ID of the web integration to delete.
Responses
204
Web integration deleted successfully.
404
application/json
Web integration not found.
The error response object describing the error from the handling of an HTTP request.
- application/jsonobject
The error response object describing the error from the handling of an HTTP request.
application/json properties
- errorsarray of objects
- traceIdstring
A unique identifier for tracing the error.
-
curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations/{id}" \
-X DELETE \
-H "Authorization: Bearer <API-key>"
const https = require('https')
const data = JSON.stringify("")
const options = {
'hostname': 'https://your-tenant.us.qlikcloud.com',
'port': 443,
'path': '/api/v1/web-integrations/{id}',
'method': 'DELETE',
'headers': {
'Authorization': 'Bearer <API-key>'
}
}
const req = https.request(options)
qlik web-integration rm <web-integrationId>