Skip to content

Webhook ​

角色 ​

Webhook 用于向外部系统投递 run 相关事件。

模型 ​

v1 使用 run-scoped WebhookSubscription:

  • 在创建 run 时声明
  • 在 run 生命周期内生效
  • 由平台异步投递

核心字段 ​

  • url
  • eventTypes
  • headers
  • algorithm
  • secretRef

规范要求 ​

  • Webhook 投递语义为“至少一次”
  • 请求头 MUST 包含稳定的 eventId 与 eventType
  • 如启用签名,服务端 MUST 基于原始 body 计算签名
  • 下游 SHOULD 使用 eventId 和资源 version 做幂等

白皮书与规范内容以仓库真源为准。