文档高级功能
网络钩子
了解项目网络钩子页面，并在其嵌入式门户未就绪时进行恢复。
网络钩子让另一项服务接收来自 Runner 项目的选定事件。这是一项高级的、安全敏感的功能：仅在您知道哪项服务应接收事件以及该服务如何验证事件时才使用它。
入口路径
仅通过 Runner 为您的工作区提供的入口打开项目网络钩子页面。如果没有入口，请勿猜测 URL；请参阅功能可用性或询问支持该功能是否已启用。
开始前
- 仅当 Runner 或支持公开批准的入口时才使用网络钩子。
- 了解预期的接收服务及其如何验证事件。
- 将端点地址、签名密钥和交付的数据视为敏感信息。
Runner 显示的内容
Runner 在显示嵌入式管理门户之前准备网络钩子服务。
| 页面状态或控件 | 其含义或作用 |
|---|---|
| 加载中… | Runner 正在检查网络钩子服务是否就绪。 |
| 网络钩子平台正在初始化 | 设置仍在进行中。请等待并保持页面打开，或稍后返回。 |
| 初始化耗时比预期长 | 在正常等待时间后设置尚未完成。重试要求 Runner 再次配置服务。 |
| 重试中… | 重试正在进行中；按钮在请求完成前保持不可用。 |
| 错误消息 | Runner 无法准备服务。为支持保留可见消息。 |
| 嵌入式网络钩子门户 | 服务已就绪。此提供商管理的门户内的确切标签和控件可能会更改，因此请遵循那里显示的说明，而不是依赖本指南中的固定按钮名称。 |
| 重新连接 Shopify | 当较旧的 Shopify 连接需要新的网络钩子权限时，打开 Shopify 集成页面。在期望 Shopify 事件到达之前重新连接。 |
从长时间初始化中恢复
- 等待初始化消息完成。
- 如果出现初始化耗时比预期长，请选择重试一次。
- 等待嵌入式门户替换初始化屏幕。
- 如果再次出现错误，请保存项目名称和确切消息，然后联系支持，而不是重复重试。
在需要时重新连接 Shopify
- 阅读重新连接您的 Shopify 商店通知。
- 选择重新连接 Shopify。
- 在 Shopify 集成页面上完成连接流程。
- 返回网络钩子并确认重新连接通知已消失，然后再依赖事件交付。
重新连接会更改商店的集成授权。只有被允许管理该商店连接的人员才应继续。
安全说明
- 将端点地址、签名密钥和事件内容视为敏感信息。
- 仅当其所有者提供了正确的安全地址时，才添加或更改目标。
- 查看嵌入式门户内显示的每个确认；其操作可能会影响未来的交付。
- 如果签名值被泄露，请在发送更多事件之前在 Runner 的网络钩子服务和接收系统中替换它。
故障排除
| 问题 | 后续步骤 |
|---|---|
| 没有网络钩子条目 | 此工作区中未公开该功能。检查功能可用性。 |
| 初始化未完成 | 使用重试一次，然后如果重复，请报告确切状态。 |
| 出现错误消息 | 为支持保留完整消息和项目名称。 |
| Shopify 重新连接通知仍然存在 | 从集成页面完成重新连接，然后重新加载网络钩子一次。 |
| 嵌入式门户为空白或行为不同 | 重新加载一次。如果持续存在，请捕获可见内容；嵌入式提供商界面可能因帐户或版本而异。 |