为了改善商户体验,帮助通过 API 管理订单的商户/ERP 更快地收到准确、一致的信息,我们进行了下列两项更新:
更新1:开放订阅Webhook!
现在,拥有私服应用/开放服务应用的商户/ERP 现可订阅 Webhook,以在订单的相关事件发生后收到实时通知。Webhook 涵盖了与订单有关的各种主题。具体操作如下:
1、拥有私服应用的商户
拥有私服应用的商户可先登录商户平台,然后前往“账户”>“API 设置”创建 Webhook。也可以通过 API 完成这项操作,点击此处,查看 V3 版 Webhook 文档了解详情。
2、ERP 合作方可先登录 ERP 平台
ERP 合作方可先登录 ERP 平台,然后前往“账户”>“API 设置”,为开放服务应用创建 Webhook。
Webhook 是 Wish 为 V3 版 API 开发的一项新功能,目前我们正在努力增加主题,将来有望涵盖更多类型的事件。点击此处,了解有关 Webhook 的更多信息,包括 Webhook 创建指南以及我们的 Webhook 订单主题清单。
更新2:发布两个新的V3版订单API端口
我们发布了两个新的 V3 版订单 API 端口,改进了目前的 V2 版订单 API 端口的功能。新端口如下:
- GET /api/v3/orders
- GET /api/v3/orders/<id>
新端口增加了以下功能:
- 使用新的“order_type”参数,按订单类型(Wish Express、FBW、FBS、LTL、A+ 物流计划)进行筛选
- 使用新的“states”参数,按订单状态(APPROVED、SHIPPED、REFUNDED、REQUIRES_REVIEW)进行筛选
- 使用新的“sort_by”参数,按订单释放时间和更新时间进行排序
在这些变更的基础上,V3 版订单 API 端口将采用新的响应架构,其中包含经过重组的属性结构和更新的文档。
点击此处,了解有关新的V3版订单API端口和响应构架的更多详情。