作为Zalando履行解决方案持续改进的一部分,已经引入了一个新的API端点,用于检索收到的物品。此更改将于2025年5月1日生效。
正在改变的是什么
当前的端点"GET /received-items/{merchant-id}"将被弃用,并被"GET /reports/received-items/{merchant-id}"替代
Lengow已经集成了这个新的端点,如果你直接使用Lengow Zalando履行解决方案,不需要你采取任何行动。请查阅Lengow API文档 这里。
然而,如果你在自定义集成中使用旧的端点,你必须相应地更新你的系统。
新端点的改进
Zalando已经引入了几项增强功能:
- 扩展时间间隔:检索长达1年的数据(以前限制为100天)。
- 基于光标的分页:使用next_page_token,无需手动调整时间间隔即可更轻松地检索数据。
- 删除未使用或冗余的字区分:"site_id (location_id的副本)"; "parent"; "tour_number"; "consumed_timestamp"。
- 保留received_timestamp,表示物品实际接收的时间。
- 添加了两个新的可选字区分:"merchant_item_id"; "merchant_article_id"。
(只有在入库时提供了这些字区分,才会包含这些字区分。)
查看Zalando API文档 这里。
你需要做什么
2025年5月1日前需要采取的行动
如果你在自定义设置中使用已弃用的端点"GET/received-items/{merchant-id}",请确保:
- 切换到新的端点:"GET /reports/received-items/{merchant-id}"
- 调整你的数据解析以适应新的字区分和分页
- 停止使用已删除的字区分
旧的端点将在2025年5月1日完全停用。
原始消息
[...]
这个新的端点带来了一些改进:
我们将时间间隔限制从100天延长到1年。
它支持基于光标的分页,允许你通过简单地提供下一页令牌,无需调整时间间隔,就可以无缝地检索下一组数据。
已经消除了无关和重复的字区分:
site_id和location_id字区分表示相同的值,所以我们已经删除了site_id。
已经删除了parent和tour_number,因为这些字区分未被使用。
已经删除了consumed_timestamp字区分,因为它表示只对内部使用的数据。请注意,received_timestamp字区分仍然存在,因为它表示物品实际入库的时间。
我们还添加了两个新的字区分:
引入了merchant_item_id和merchant_article_id字区分,如果在物品入库过程中提供了商家指定的数据,就可以提供这些数据。
[...]