用途:在解析 JSON 之前先完成 Flexport Webhook 认证,并把 Webhook 投递视为可能需要通过 API 对账的通知。
主要能力:支持 SHA-1 与 SHA-256 签名,推荐使用 X-Hub-Signature-256;对原始 UTF-8 请求体计算 HMAC-SHA256,解析签名头,拒绝格式错误或长度不等的输入,并使用常量时间比较。支持按事件类型白名单路由(如 /shipment#created、/purchase_order#updated),去重与幂等处理,以及在发现投递缺口时通过 REST /events 或资源读取进行对账。
使用方式:在 Flexport 账户设置中配置回调地址与高熵密钥,记录预期事件类型与负责人;在中间件改写编码或 JSON 结构前读取原始请求字节;验证通过并持久化入队后尽快返回 HTTP 200,业务处理移出请求路径;使用提供方事件标识或稳定载荷摘要去重;REST 调用使用缓存 OAuth 2.0 客户端凭据 Bearer 令牌(audience 为 https://api.flexport.com)或明确接受的宽泛 API 密钥,MCP 调用使用 https://mcp.flexport.com/mcp 的已认证连接。
适用场景:构建 Webhook 接收端、轮换 Webhook 密钥、处理 Flexport 事件与对账。
限制:不要臆造 Webhook 重放端点或重试计划;不同工作负载使用独立凭据,切勿记录凭据或令牌;未知事件类型应隔离元数据并与当前事件文档比对;重复投递在确认先前持久化操作后返回成功。资料未提供具体价格、平台支持范围或完整代码示例。