用途:为 Workhuman 相关业务变更选择风险最低的受支持摄取方式,并治理其交付。
主要能力:盘点受支持模式(托管连接器、文档化事件交付、增量读取、定时报表或导出、经批准的人工交接);按可支持性、真实性验证、新鲜度、重放、可观测性、容量、隐私与成本选择,而非默认偏好 webhook;冻结 schema,定义稳定标识、去重、顺序假设、检查点、生效日期与删除行为;实现先校验后确认、隔离、有界重试、死信处理与权威对账;用合成样例测试有效、无效、重复、延迟、乱序、缺字段、重放、凭据撤销、中断与部分失败场景;变更端点、计划、连接器或订阅时提交暴露面、负责人、回滚、密钥方案与审批;先金丝雀再与权威源对账,仅保留脱敏运行证据。
认证与限制:公开页面确认 Workhuman 提供托管集成与开放 API,但未发布通用 webhook 注册路由、事件目录、签名头或重试计划;在客户授权文档定义前,应视为 webhook 交付不可用,不得自行虚构 HMAC 头或接受未认证事件。推送模式须使用客户合同规定的确切真实性机制与密钥生命周期,轮询、报表、导出或连接器须使用最小权限授权主体。
审批边界:未经具名负责人批准,不得暴露端点、创建订阅、启用连接器、轮询生产、重放消息或变更下游记录。
输出:所选模式与依据、冻结 schema、认证方案、去重与顺序策略、失败测试、变更预览、金丝雀对账与回退方案。
错误处理:webhook 合同未文档化时改用获批连接器、轮询、报表、导出或人工方式;真实性校验失败则拒绝并隔离,不写入下游;检查点与源不一致时停止推进、对账该窗口并保留重放证据。
后续:当租户能力、下游权威或新鲜度要求变化时,重新评审所选交付模式。