用途:为开发者提供 Contentstack Webhook 的配置与消费建议,用于实时事件通知,把 CMS 事件接入站点重建、搜索索引、Slack、CI/CD 等外部系统。
主要能力:事件通道选择(形如 {module}.{action},如 entries.create、entries.update、entries.publish、entries.unpublish、assets.publish、content_types.update、entries.workflow_stage_change,仅在确需全部事件时用 $all);载荷处理(含 module、api_key、event、triggered_at、data 与分支信息,接收端只需标识符时建议 concise_payload: true);签名校验(生产环境校验 X-Contentstack-Signature,按 HMAC-SHA256 对原始请求体用 webhook secret 计算,缺失或无效即拒绝);发布风暴处理(一次发布含多项时每项可能产生一个事件,可用载荷中的 source 键识别并按发布去重或批处理);可靠接收端设计(校验签名、30 秒内返回 2xx、确认后异步处理、幂等处理重复投递);重试策略(手动重试会记录以便重执行,自动重试采用指数退避,可通过执行日志查看投递尝试、HTTP 状态码与响应体);限制说明(每 stack 最多 100 个 webhook,webhook 为全局模块但可按分支限定,组织级 Webhook Configuration 可设置每秒最大连接数)。
使用方式:该技能为只读咨询,工具限于 Read、Grep、Glob,不创建、修改、删除或发送 webhook,仅依据文档与执行日志给出排障建议。
适用场景:配置 webhook、选择事件通道、处理载荷、校验签名、调试投递问题或集成外部系统时。
限制与安全:不执行任何变更或外部操作;绝不暴露 webhook secret 或凭据,密钥应存于环境变量并仅在服务端使用,示例中不回显原始密钥、令牌或签名。具体价格、平台支持范围等资料暂未提供。