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 Sense SaaS.

Endpoints

Skip to section
GET/v1/web-integrations
POST/v1/web-integrations
GET/v1/web-integrations/{id}
PATCH/v1/web-integrations/{id}
DELETE/v1/web-integrations/{id}

List web integrations

Retrieves web integrations matching the query.

Query Parameters GET /v1/web-integrations

endingBefore
optional
string

The target web integration ID to start looking before for web integrations. Cannot be used in conjunction with startingAfter.

limit
optional, default=10, maximum=100
number

The number of web integration entries to retrieve.

sort
optional, default='+name'
string

The field to sort by. Prefix with +/- to indicate ascending/descending order.

Enum:

name

+name

-name

startingAfter
optional
string

The target web integration ID to start looking after for web integrations. Cannot be used in conjunction with endingBefore.

tenantId
optional
string

The tenantId to filter by.

Responses GET /v1/web-integrations

200
application/json

An array of web integration objects

default
application/json

Unexpected error.

GET/v1/web-integrations

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations" \
 -H "Authorization: Bearer <API-key>"

Response GET /v1/web-integrations

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "created": "2022-08-15T13:39:44.120Z",
      "tenantId": "string",
      "createdBy": "string",
      "lastUpdated": "2022-08-15T13:39:44.120Z",
      "validOrigins": []
    }
  ],
  "links": {
    "next": {
      "href": "string"
    },
    "prev": {
      "href": "string"
    },
    "self": {
      "href": "string"
    }
  }
}

Create web integration

Creates a web integration.

Request Body POST /v1/web-integrations

application/json

No description

Responses POST /v1/web-integrations

201
application/json

Web integration created successfully.

400
application/json

Invalid request was made.

403
application/json

Requestor not allowed to create a web integration.

POST/v1/web-integrations

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations" \
 -X POST \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '{"name":"My Web Integration","validOrigins":["https://thirdPartyApp.com"]}'

Request POST /v1/web-integrations

{
  "name": "My Web Integration",
  "validOrigins": [
    "https://thirdPartyApp.com"
  ]
}

Response POST /v1/web-integrations

{
  "id": "string",
  "name": "My Web Integration",
  "links": {
    "self": {
      "href": "http://mytenant.region.domain/api/v1/web-integrations/id"
    }
  },
  "created": "2022-08-15T13:39:44.120Z",
  "tenantId": "string",
  "createdBy": "string",
  "lastUpdated": "2022-08-15T13:39:44.120Z",
  "validOrigins": [
    "https://thirdPartyApp.com"
  ]
}

Get web integration by ID

Retrieves a single web integration by ID.

Path Parameters GET /v1/web-integrations/{id}

id
string<uid>

The ID of the web integration to retrieve

Responses GET /v1/web-integrations/{id}

200
application/json

Web integration found.

404
application/json

Web integration not found.

GET/v1/web-integrations/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations/{id}" \
 -H "Authorization: Bearer <API-key>"

Response GET /v1/web-integrations/{id}

{
  "id": "string",
  "name": "string",
  "created": "2022-08-15T13:39:44.121Z",
  "tenantId": "string",
  "createdBy": "string",
  "lastUpdated": "2022-08-15T13:39:44.121Z",
  "validOrigins": []
}

Update web integration by ID

Updates a single web integration by ID.

Path Parameters PATCH /v1/web-integrations/{id}

id
string<uid>

The ID of the web integration to update.

Request Body PATCH /v1/web-integrations/{id}

application/json

No description

Responses PATCH /v1/web-integrations/{id}

204
object

Web integration updated successfully.

400
application/json

Invalid request was made.

404
application/json

Web integration not found.

PATCH/v1/web-integrations/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations/{id}" \
 -X PATCH \
 -H "Authorization: Bearer <API-key>" \
 -H "Content-type: application/json" \
 -d '[{"op":"replace","path":"/name","value":"New name"}]'

Request PATCH /v1/web-integrations/{id}

[
  {
    "op": "replace",
    "path": "/name",
    "value": "New name"
  }
]

Delete web integration by ID

Deletes a single web integration by ID.

Path Parameters DELETE /v1/web-integrations/{id}

id
string<uid>

The ID of the web integration to delete.

Responses DELETE /v1/web-integrations/{id}

204
object

Web integration deleted successfully.

404
application/json

Web integration not found.

DELETE/v1/web-integrations/{id}

curl "https://your-tenant.us.qlikcloud.com/api/v1/web-integrations/{id}" \
 -X DELETE \
 -H "Authorization: Bearer <API-key>"

Error

An error object.

Properties

code
string

The error code.

meta
optional
object

Additional properties relating to the error.

title
string

Summary of the error.

detail
optional
string

A human-readable explanation specific to this occurrence of the error.

source
optional

References to the source of the error.

status
string

The HTTP status code.

Errors

An array of error objects.

Properties

errors

No description

WebIntegration

A web integration object.

Properties

id
string<uid>

The unique web integration identifier.

name
string

The name of the web integration.

created
string<date-time>

The time the web integration was created at.

tenantId
string<uid>

The tenant that the web integration belongs too.

createdBy
string<uid>

The user that created the web integration.

lastUpdated
string<date-time>

The time the web integration was last updated at.

validOrigins
Array<string<uri>>

The origins who are allowed to make requests to the tenant.

WebIntegrationPatch

A JSON Patch document as defined in http://tools.ietf.org/html/rfc6902.

Properties

op
string

The operation to be performed.

Enum:

replace

path
string

A JSON Pointer.

Enum:

/name

/validOrigins

value
string

New value to be used for this operation.

WebIntegrationPatchSchema

Array<WebIntegrationPatch>

Properties

op
string

The operation to be performed.

Enum:

replace

path
string

A JSON Pointer.

Enum:

/name

/validOrigins

value
string

New value to be used for this operation.

WebIntegrationPost

The creation of a web integration response.

Properties

id
string<uid>

The unique web integration identifier.

name
string

The name of the newly created web integration.

links
optional

Pagination links

created
string<date-time>

The time the web integration was created at.

tenantId
string<uid>

The tenant that the web integration belongs too.

createdBy
string<uid>

The user that created the web integration.

lastUpdated
string<date-time>

The time the web integration was last updated at.

validOrigins
Array<string<uri>>

The origins who are allowed to make requests to the tenant.

WebIntegrationPostSchema

Properties

name
string

The name of the web integration to create.

validOrigins
optional
Array<string<uri>>

The origins who are allowed to make requests to the tenant.

WebIntegrations

An array of web integration objects.

Properties

data

No description

links
optional

Pagination links

v0.392.12
Was this page helpful?