您现在可以为 Webhook 订阅分配一个可选名称,以简化识别和管理。此功能适用于基于 TOML 的订阅以及通过 Admin API(通过 GraphQL Admin API 创建的订阅)创建的订阅。
为 Webhook 命名在以下场景中尤为有益:当您有多个订阅指向同一端点,或监听具有不同过滤条件的同一主题时。当 Webhook 被投递时,其名称会包含在请求头中,使您无需解析负载主体即可路由和处理传入的 Webhook。
对于 Admin API 订阅,Webhook 名称在每个商店内必须唯一。对于声明式订阅,名称在每个应用内必须唯一。名称长度最多为 50 个字符,可包含字母数字字符、下划线和连字符。
要为基于 TOML 的订阅设置名称,请更新 name 字段中的 shopify.app.toml webhook 配置。从 2026-04 中,您可以命名管理 API 订阅,name 字段可以通过 WebhookSubscription GraphQL 对象以及通过 webhookSubscriptionCreate 和 webhookSubscriptionUpdate 突变来设置。

