為工作流程建立 Webhook

Webhook 向您提供在工作流程中使用 Qlik Cloud 系統事件作為觸發的方式。建立 Webhook 後，只要發生定義的系統事件，就會自動將 JSON 請求傳送至 Webhook 端點。您可以使用 Webhook 將事件資料傳送至任何可以接收 JSON 資料的應用程式。

Webhook 屬性

若要建立 Webhook，必須設定 Webhook 和端點屬性，並選擇 Qlik Cloud 事件類型。

Webhook 屬性
屬性	描述
名稱	Webhook 名稱。
Description (選填)	Webhook 描述。
URL	Webhook 端點的 URL。URL (Webhook 端點) 必須是完全合格的網域名稱 (FDQN) 並且必須使用 HTTPS 通訊協定。端點不可以是 IP 位址。
Secret (選填)	用於 Webhook 驗證的密碼。密碼必須介於 32 個字元和 64 個字元之間。若您建立 webhook 密碼，這屬於作為 qlik-signature 附加到 HTTP 請求的雜湊。
Headers (選填)	可附加到 HTTP 請求的標頭。

每個 Webhook 都以一個或多個事件類型來設定。

Webhook 的事件類型
資源	事件類型
應用程式	已建立、已刪除、資料已更新、已載入、已發佈、已匯出資訊備註資料更新事件意指正在重新整理的資料。載入事件意指正在載入的 Qlik Sense 應用程式和相關資料表格。
使用者	已建立、已刪除

Webhook 會等待其中一個事件發生，發生後，就會將事件資料傳送至 Webhook 端點。資料會傳遞至端點 URL 作為 JSON 請求。

若要進一步瞭解事件裝載，請參閱 Qlik 開發人員入口網站：API 事件。

範例：應用程式已刪除事件類型的 JSON 請求

Request
URL
https://api.blendr.io/v1/widgets/F502987A-AF89-4992-8127-F28794C5A74A?X-Execution-Token=xxxxx
Headers
{
    "Content-Type": "application/json",
    "Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
    "User-Agent": "Qlik Webhook"
}
Body
{
    "cloudEventsVersion": "0.1",
    "source": "com.qlik/engine",
    "contentType": "application/json",
    "eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7",
    "eventTime": "2021-03-08T14:51:29Z",
    "eventTypeVersion": "1.0.0",
    "eventType": "com.qlik.v1.app.deleted",
    "extensions": {
        "ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI",
        "tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN",
        "userId": "vNRGrDZIypJtcGTzauw59BbpqbmI"
    },
    "data": {
        "attributes": {
            "id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78",
            "name": "New App",
            "createdDate": "2021-03-08T14:51:28.888Z",
            "modifiedDate": "2021-03-08T14:51:29.316Z",
            "owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11",
            "ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI",
            "published": false,
            "hasSectionAccess": false
        }
    }
}