本页内容
测试 Webhook
使用公共 Webhook 接收器测试 Webhook 并确保获得所需的数据。
通过测试 Webhook,您可以验证配置过程,并检查和解析从 Mist 收到的事件消息。如果您没有可用的 Webhook 接收器,您可以使用公共免费服务。许多此类服务使您能够接收和检查来自瞻博网络 Mist 的传入 Webhook POST 消息。
这些公共站点会创建一个随机 URL,您可以临时使用该 URL。您收到的数据是短暂的,一旦您关闭浏览器,就会被删除。使用浏览器中的这些站点之一,可以从消息有效负载中识别参数数据,以帮助创建工作流。
配置 Webhook 后,您可以触发它并在公共 Webhook 接收器上收到这些消息时查看这些消息。
其中两个免费测试 Webhook 接收器是:
这些站点不由瞻博网络维护,使用风险自负。
Webhook 测试器
您可以使用 Webhook 测试工具轻松测试和监控 Mist 组织的 Webhook。Webhook 测试器可在此处获得 Mist Webhook 测试器。这是一个应用程序,它会自动在 Mist 组织中创建和删除 Webhook 配置以接收它们,并在表格中显示收到的 Webhook 消息。
-
只有本地 Mist 帐户可以使用此应用程序(不支持 SSO 用户)。
-
仅支持具有超级用户角色的管理员(超级用户可以配置组织级别的 Webhook)。
下图解释了该应用程序的工作原理。

要使用 Webhook 测试器,只需:
导航至 Mist Webhook 测试器。
在配置弹出窗口中,选择:
内存中的最大事件数 - 这是要存储在应用程序内存中的最大事件数。
主题 - 这些是要接收的 Webhook 主题。仅支持有限的 Webhook 主题子集,所有其他消息都将被丢弃。
组织 - 一个或多个 Mist 组织。应用程序将自动在所选组织上创建新的 Webhook 配置,以将启用的主题发送到应用程序。
点击 保存。
当事件发生时,这些 Webhook 将被发送到表中,供您监控和查看。表格中将为您显示日期、主题、事件类型、组织、站点、设备名称、设备 MAC 和事件详细信息等信息。
有关更多详细信息,请参阅 https://github.com/Mist-Automation-Programmability/mist_webhook_monitor?tab=readme-ov-file。
测试端到端连接
借助 Webhook,您可以测试从 Mist 云实例到定义的 Webhook 接收器的端到端连接,以确认您正在接收 Webhook 并能够处理它。这是一个用于测试 Webhook 是否正常工作的 Webhook。它的功能与用于测试网络连接的 ping 相同,但您正在测试 Webhook 功能。这将验证没有设备(防火墙或路由器)阻止两个端点之间的通信。
这可以通过 API(从您的 REST 客户端)向您的组织发出 POST(在本例中为您的组织)配置的 Webhook (id) 来完成,如以下示例所示:
POST
/api/v1/orgs/203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx/webhooks/032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx/ping
成功的结果如下所示:
{
"topic": "ping",
"events": [
{
"id": "032b9cb1-80af-4edc-xxxx-xxxxxxxxxxxx",
"name": "my webhook",
"org_id": "203d3d02-dbc0-4c1b-xxxx-xxxxxxxxxxxx",
"timestamp": 1725375149.0829651
}
]
}
您也可以通过瞻博网络 Mist 门户完成此作:
导航到 组织 > 管理员 > 设置。
找到 Webhooks 部分,然后单击 Add Webhook 按钮。
选择适当的 Webhook 类型,为测试 Webhook 命名,然后将从免费 Webhook 测试接收器网站获取的测试 URL(请参阅上面提供的链接)粘贴到 URL 字段中。
- 选择要接收消息的 Webhook 主题,并设置任何其他必要的设置。
- 最后,选择 “添加”。

找到“组织设置”页面的“ Webhooks ”部分中列出的测试Webhook,然后单击“ 查看” 以查看投放事件。您可以检查这些事件以查看 Webhook 的交付状态,以确认您正在接收 Webhook 并能够处理它。

其他测试信息
要查看其他 Webhook 测试信息,例如如何测试您的 Web 服务器是否能够接收和处理 Mist Webhook,请参阅 验证交付中的信息。
若要了解如何将 ping 事件发送到站点 Webhook,请参阅 Ping 站点 Webhook。
若要了解如何将 ping 事件发送到组织 Webhook,请参阅 Ping 组织 Webhook。