Page History
...
Description
Handles a page event and returns the events that occurred in any of the sessions in heirarchy.
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id. |
Request body
At least the element that triggered the event and all editable fields on the page must be included in the request.
| Code Block | ||
|---|---|---|
| ||
{
elementKey: string, // Key of the element the event originates from
fields: [{
key: string, // Key of the field
values: string[], // Values of the field, an array even if the field is not multivalued
}], // Data of all fields on the page
parameters: { [string]: string } // Additional parameters that may be passed to the backend
} |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"elementKey": "P960-C2-B1",
"fields": [
{
"key": "P960-C1-F0",
"values": [
"testValue"
]
},
{
"key": "P960-C1-F6",
"values": [
"testValue2"
]
}
]
} |
Response body
Returns an event response, for more info about an event response see: REST Events V1.
| Code Block | ||
|---|---|---|
| ||
{
events: { EventResponse }[]
} |
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"events": [{
"sessionId": "45992123-f893-4b22-a6a3-ff648b63267c",
"changes": {
"changes": [
{
"type": "add",
"key": "P501-C1-B0",
"model": {
"key": "P501-C1-B0",
"name": "Annuleer",
"properties": {
},
"disabled": false,
"refresh": false,
"caption": "Annuleer",
"type": "button",
"styles": [
]
}
},
},
"type": "page"
}]
} |
...
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id. |
Response
204 No Content
Create widget
| Code Block | ||
|---|---|---|
| ||
POST /api/v2/session/{sessionId}/widget/{infoKey} |
Description
provides a service that creates a child-session using the provided sessionId as its parent, to be used for widgets.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id |
| infoKey | string | The info key of the widget to load, available in properties.info of a page mode of type dashboard_flowwidget |
Reponse
The sessionId of the existing or newly created session.
| Code Block | ||
|---|---|---|
| ||
{"sessionId":"a487f65e-6804-4803-bf4b-c89e45f97e38"} |
Create external flow widget
Starting an external flow consists of multiple calls.
Init
| Code Block | ||
|---|---|---|
| ||
POST /api/v2/session/{sessionId}/externalflow/init |
Requestbody
| Code Block | ||
|---|---|---|
| ||
{"configurationId":"fd308ecf-bf93-4061-bbc7-7cace2cde764","baseUrl":""} |
Description
provides a service that initializes an external flow starting from your current session.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id |
| configurationId | string | The info key of the widget to load, available in properties.configurationId of a page model of type external_flow |
Reponse
| Code Block | ||
|---|---|---|
| ||
{"configurationId":"fd308ecf-bf93-4061-bbc7-7cace2cde764","baseUrl":""} |
Start
| Code Block | ||
|---|---|---|
| ||
POST /api/v2/externalflow/start |
Requestbody
| Code Block | ||
|---|---|---|
| ||
{"configurationId":"fd308ecf-bf93-4061-bbc7-7cace2cde764"} |
Description
provides a service that creates a child-session, to be used for widgets.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id |
| configurationId | string | The info key of the widget to load, available in properties.configurationId of a page model of type external_flow |
Reponse
The sessionId of the existing or newly created session. After starting a session its initial page contents may be obtained via a POST to /api/v2/session/{sessionId}/load.
| Code Block | ||
|---|---|---|
| ||
{"sessionId":"9f79ac63-f994-4b9e-8a4d-86ef5a561291"} |
Handling files
Endpoints that go with AQ_File_Upload/AQ_File_Download containers.
Upload file
| Code Block | ||
|---|---|---|
| ||
POST /api/v2/session/{sessionId}/file/{configurationId}/upload |
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id. |
| configurationId | string | The configuration id. |
Response body
Returns an event response, for more info about an event response see: REST Events V1.
Download a file
| Code Block | ||
|---|---|---|
| ||
GET /api/v2/session/{sessionId}/file/{configurationId}/download |
Description
Gets the file from the specified connection based on its configuration
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id |
configurationId | string | The property configuration id, available |
Query Parameters
| Query Parameter | Expected Type | Description |
|---|---|---|
| error-redirect | string | Optional. Specifies the URL to be redirected to if the file download fails. If not provided, the default JSON error output will be used instead. |
Example response
The requested file, transferred using Content-Disposition: attachment.
Check authorization
| Code Block |
|---|
GET /api/v2/session/{sessionId}/file/{configurationId}/checkauthorization |
Description
Check if the user has the authority to download the file.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id |
configurationId | string | The configuration id |
Example response
200 OK, if the current user is authorized to download the file
401 Unauthorized, otherwise
Documents
Use to render a Blueriq document or page. A call to this service returns the binary data of the document or page.
Render a document
| Code Block | ||
|---|---|---|
| ||
GET /api/v2/session/{sessionId}/document/{documentName}/{type} |
Description
Renders a document and returns its binary value.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The id of the session. |
| documentName | string | Name of the document. |
| type | string | Type of document (e.g. PDF). |
Query Parameters
| Query Parameter | Expected Type | Description |
|---|---|---|
| error-redirect | string | Optional. Specifies the URL to be redirected to if the document download fails. If not provided, the default JSON error output will be used instead. |
Response body
Transfers the binary data of a document using Content-Disposition: attachment
Render a page
| Code Block | ||
|---|---|---|
| ||
GET /api/v2/session/{sessionId}/document/page/{pageName}/{type} |
Description
Renders a page and returns its binary value.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The id of the session. |
| pageName | string | Name of the page. |
| type | string | Type of page (e.g. PDF). |
Query Parameters
| Query Parameter | Expected Type | Description |
|---|---|---|
| error-redirect | string | Optional. Specifies the URL to be redirected to if the document download fails. If not provided, the default JSON error output will be used instead. |
Response body
Transfers the binary data of a page using Content-Disposition: attachment
Images
Retrieve an image
| Code Block | ||
|---|---|---|
| ||
GET api/v2/session/{sessionId}/image/{imageName} |
Description
Returns the binary data of a named Blueriq image.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The id of the session. |
| imageName | string | The name of the image. |
Response body
Returns the binary data of an image.
Retrieve a QR Code image
| Code Block | ||
|---|---|---|
| ||
GET api/v2/session/{sessionId}/image/{imageName}/key/{key} |
Description
Returns the binary data of a named Blueriq QR Code image.
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The id of the session. |
| imageName | string | The name of the image. |
| key | string | The element key of the image. |
Response body
The binary data of an image.
Inference details
The DMN service is part of the development plugin and can be used to get inference details for attribute instances
Get Decision Tree
| Code Block | ||
|---|---|---|
| ||
GET /api/v2/session/{sessionId}/dmn/{entityName}/{instanceId}/{attributeName} |
Description
Gets a decision tree model for the specified attribute instance
Parameters
| URL Segment | Expected Type | Description |
|---|---|---|
| sessionId | string | The session id to create an event response for |
| entityName | string | Entity name for the attribute for which the decision tree is requested |
| instanceId | string | Instance id for the attribute for which the decision tree is requested |
| attributeName | string | Name of the attribute for which the decision tree is requested |
Example response
A decision tree for DMN starts with a rootNode and it is possible that there are 0 or more usedDecisions. A used decision describes an attribute that is used to derive the parent attribute.
| Code Block | ||
|---|---|---|
| ||
{
"rootNode": {
"ruleName": "DMNEntity.DataRuleEndResult",
"justification": null,
"usedDecisions": [
{
"ruleName": "DataRuleForPage",
"justification": null,
"usedDecisions": [],
"entityName": "DMNEntity",
"attributeName": "DataRule",
"attributeValues": [
"44"
],
"sourceType": "System",
"defaultRuleType": null,
"instanceId": "40c05cc5-8ddf-48a3-8d5d-53228ca7305c"
}
],
"entityName": "DMNEntity",
"attributeName": "DataRuleEndResult",
"attributeValues": [
"1342"
],
"sourceType": "Default",
"defaultRuleType": "expression",
"instanceId": "40c05cc5-8ddf-48a3-8d5d-53228ca7305c"
}
} |
Language
Get current languages
| Code Block |
|---|
GET /api/v2/session/{sessionId}/language |
Description
Returns a status code 200 if request was successful and a body containing a JSON Array with the available languages that are available in the current project.
Example response
| Code Block |
|---|
[
{
"code": "nl-NL",
"name": "Nederlands"
},
{
"code": "en-US",
"name": "English"
}
] |
Set language
| Code Block |
|---|
POST /api/v2/session/{sessionId}/language/current?languageCode=nl-NL |
Description
Sets the specified language in the languageCode parameter for the currently active project. If the specified language does not exist a Bad Request status code is returned.
Standard response codes
All services return a 200 response code on successful requests and a 500 response code if an error occurs. For more information about errors see REST Errors V2.
Overview
Content Tools