增强型配送配置文件 Webhook 现在包含额外的有效负载字段
我们通过添加更全面的负载信息改进了profiles/update网络钩子,这一增强显著提高了网络钩子的可靠性并减少了不必要的去抖动。
更新内容
此前,profiles/update网络钩子的负载中仅包含配置文件ID,这种极简的负载导致我们的网络钩子投递系统对同一配送配置文件的多次快速更新进行去抖动处理,这意味着在15分钟窗口期内只有第一次更新能到达您的应用。
现在,当您订阅profiles/update网络钩子时,您将收到以下附加字段:
- name:配置文件的显示名称
- default:指示这是否为默认配送配置文件
- profile_type:配送配置文件的类型
- version:一个整数,每当配置文件或其运费设置被修改时递增
为何重要
如果您的应用响应配送配置文件更改(例如用于运费同步、履约优化或承运商集成),您现在可以可靠地接收每一次更新。当商家快速连续更改其运费配置时,这一点尤其有用,例如:
- 调整基于重量的费率条件
- 修改区域配置
- 按顺序更新多个运费
新的version字段充当配置文件当前状态的指纹,每当配置文件或其关联的运费率被修改时该字段就会递增,从而确保每个网络钩子都具有唯一的负载且不会被去抖动。
使用增强型有效负载
增强型有效负载结构如下:
{ "id": 123456789, "name": "Standard Shipping", "default": false, "profile_type": "shipping", "version": "1" }此增强功能现已在API版本unstable中提供,并将包含在下一次稳定的API发布中。

