Webhook 主题
在组织、站点或两个级别启用 Webhook 后，选择要接收其消息的主题。
使用下表了解详细信息。
| 主题 | 用途和有效负载详细信息 |
|---|---|
| 警报（警报） | 用户为设备和基础架构、Marvis 操作和安全选择的警报。要在瞻博网络 Mist 门户中查找警报，请从左侧菜单中选择监控>警报>警报配置。 例子
根据警报的类型，有效负载包括组织和站点的 ID、事件类型、严重性以及聚合间隔内每种事件类型的计数等详细信息。 要查看哪些警报可用并从 REST API 客户端获取其有效负载的示例，请发出以下 API 调用：GET /api/v1/const/alarm_defs |
| 审计 | 所有 Mist 配置更改都会触发本主题的主题。 有效负载包括管理员名称和用户名、设备 ID、更改类型和更改时间戳等详细信息。 |
| 客户端加入 | 仅限客户端连接。 有效负载包括组织和站点的 ID 等详细信息;客户端连接到的接入点的 MAC 地址和名称;以及连接的 WLAN ID、频段、SSID、RSSI 和时间戳。 |
| 客户端会话 | 客户端会话信息。 有效负载包括客户端漫游或断开连接的 MAC 地址和 AP 名称、WLAN ID、频段、设备系列（“Mac”、“iPhone”、“Apple Watch”）、客户端制造商和型号、连接和断开连接的时间戳、浮动持续时间、RSSI 和终止原因等详细信息。 |
| 设备事件 | 影响接入点、交换机和网关的事件。本主题包括端口打开或关闭、AP 功率更改和通道更改等事件。 有效负载包括组织和站点的 ID、MAC 地址和设备名称以及事件时间戳等详细信息。 要查看哪些警报可用并获取其有效负载的示例，请从 REST API 客户端发出以下 API 调用：GET /api/v1/const/device_events |
| 设备故障 | 设备断开连接、重新连接和重新启动。 有效负载包括组织和站点的 ID、事件类型以及设备的 MAC 地址和名称等详细信息。 要在瞻博网络 Mist 门户中进行配置device-updowns，请从左侧菜单中选择监控>警报>警报配置。在这里，您可以配置对设备类型和警报阈值的更精细控制。 |
| MXedge-events | 瞻博网络 Mist Edge 物理和 LACP 链路状态。 |
| 乒 | 转到 Webhook URL 的 ping 事件。 有效负载包括站点 ID、Webhook ID 和名称以及时间戳。 |
| 主题 | 用途和有效负载详细信息 |
|---|---|
| asset-raw-rssi | 替换名为 asset-raw 的已弃用主题。 来自命名和过滤资产发出的数据包的原始数据。 有效负载包括组织 ID、站点、地图、AP、天线和资产等详细信息;接入点位置;RSSI;信标UUID和制造商;服务包;和数据。 |
| discovered-raw-rssi | 来自无源 BLE 发出的数据包的原始数据。 有效负载包括组织 ID、站点、地图、报告 AP 和天线等详细信息;MAC 地址;资产 ID， 制造商， 和资产/信标的 UUID;和 RSSI。 |
| 位置 | 瞻博网络 Mist SDK 客户端、无线客户端和资产的位置数据。 数据包括站点和映射 ID、X 和 Y 坐标、时间戳、客户端类型以及客户端 ID 或 MAC 地址等详细信息。 |
| NAC-会计 | 此 Webhook 会随任何瞻博网络 Mist 网络接入控制 （NAC） 帐户事件（ACCOUNTING_START、ACCOUNTING_STOP、ACCOUNTING_UPDATE）触发。有效负载包括时间戳、AP、client_ip、SSID、用户名、client_type、client_mac、nas_vendor、site_id、rx_pkts和tx_pkts等详细信息。 |
| 占用警报 | 基于配置的占用限制的占用状态。 有效负载包括组织、站点、地图和区域的 ID 等详细信息;事件（“合规-违规”或“合规-正常”）;时间戳;入住限制;和当前入住率。 |
| RSSI 区 | 接入点附近的设备。 本主题提供有关进入或退出 AP 周围区域且 AP 接收的 RSSI 高于可配置阈值的设备的信息。您可以为每个 AP 创建新的 RSSI 区域，并包括 RSSI 区域名称和 RSSI 区域阈值。 |
| sdkclient-scan-data | 瞻博网络 Mist SDK 客户端的位置数据。数据包括连接频段、通道、SSID、BSSID 和 RSSI 等详细信息;接入点的 MAC 地址;相邻接入点列表;上次看到客户端时的时间戳;和扫描的时间戳。 |
| 虚拟信标 | 虚拟信标附近的设备。 本主题提供有关已配置的 vbeacon 附近设备的信息。将此网络钩子与瞻博网络 Mist SDK 配合使用。 |
wifi-conn-raw Wifi-unconn-raw |
来自已连接和未连接设备发出的数据包的原始数据。 有效负载包括组织 ID、站点、地图和报告 AP 等详细信息;接入点的位置坐标;RSSI和频段;以及来自 Wi-Fi 信标的有效负载。它不包括客户端的位置数据。 |
| 区 | 平面图上虚拟信标的位置数据，在客户端进入或退出区域时推送。 这些数据包括站点、地图和区域 ID、时间戳、触发器（进入或退出）、客户端类型（SDK 客户端、无线客户端或资产）以及客户端 ID 或 MAC 地址等详细信息。 |
| 客户端延迟 |
站点级别跨所有客户端设备聚合的 DHCP、DNS 和身份验证延迟信息。以 10 分钟的间隔提供 10 分钟窗口的延迟数据。我们建议您使用此 Webhook 接收网络延迟数据，而不是通过 API 进行轮询。
注意：
您需要订阅 Marvis 才能订阅此网络钩子。 |