为工作流创建 Webhook

webhook 提供了一种在工作流中使用 Qlik Cloud 系统事件作为触发器的方法。一旦创建了 webhook，只要定义的系统事件发生，它就会自动向 webhook 端点发送 JSON 请求。您可以使用 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 端点。数据作为 JSON 请求传递到端点 URL。

要了解有关事件有效负载的更多信息，请参阅 Qlik Developer 门户：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
        }
    }
}