Webhook 概述

Webhook 是应用之间即时传递信息的方式。运单状态发生变化时，Tracksuite 会自动把数据发到你填写的 Webhook 地址。你可以选择需要关注的运单状态。

如何配置 Webhook

1. 在 Tracksuite 管理门户 打开 设置 → API 与 Webhook。
2. 填写接收地址，并勾选要接收的事件。一个都不勾选，则接收全部事件。
3. 保存，并在同一页复制签名密钥。地址和密钥都有值之后，才会开始投递。

事件名、请求和签名见Webhook 规范。

Webhook 安全性

由于目前同时支持 HTTP 和 HTTPS 地址，你可以使用启用了 SSL 的地址来增强安全性。你的端点也可以被其他人访问。为防止他人向你的 Webhook 提交随机数据，请务必使用 Webhook 密钥来验证请求。

Webhooks 重试

Tracksuite 用 POST 发送每次更新。接收端需在 5 秒内返回 2xx。没有返回时，同一条事件会再次发送。eventId 不变，用它去掉重复。

重试至少等待 1 分钟，之后间隔变长，最长不超过 12 小时。具体等待时间在这个范围内随机。同一条事件最多发送 12 次。