SuperAPI AI 工具集

bamboohr-webhooks-events

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:以安全边界的方式运维有权限的 BambooHR Webhook,覆盖创建、查询、更新、删除与日志端点(位于 /api/v1/webhooks)。创建响应中的 privateKey 仅返回一次,用于 HMAC-SHA256 校验,丢失后只能受控替换,无法再次获取。

主要能力:支持事件型与字段型投递;目标 URL 必须为 HTTPS,并需指定格式(json 或 form-encoded)。当事件包含 employee.updated 或 employee_with_fields.updated 时,monitorFields 为必填;省略事件时默认走字段型员工事件,同样需要监控字段。接收方 4xx 不重试,5xx 最多重试五次,间隔为 5、10、20、40、80 分钟。

使用方式:管理 Webhook 需要 OAuth 的 webhooks 作用域或获许可的 API-key 用户。创建前先准备密钥存储,创建后原子地捕获 id 与 privateKey,立即存入按租户和 Webhook ID 划分的密钥管理器,且不得进入日志、工单、测试夹具或源码控制。校验时对原始请求字节做 HMAC-SHA256,校验前不要解析或重新序列化;签名载体/头部需以当前官方文档或受控样本为准。使用常量时间比较签名,先拒绝再处理,并执行租户路由、载荷模式、事件白名单、时间戳/重放窗口与幂等键校验。仅在持久入队后确认,终态拒绝返回 4xx,可重试失败返回 5xx。

适用场景:部门变更通知等员工数据变更的集成;需要严格密钥保管与重放防护的接收端实现。

限制:本技能不授权创建、更新、删除 Webhook,也不授权接收生产 PII;事件/字段范围、目标地址、管理身份、密钥写入、增删改调用、生产流量与载荷重放均需审批。签名契约不确定时应失败关闭并查阅官方文档。具体签名头部名称等细节资料未提供,需以官方文档为准。