REST 管理 API 转 legacy：新应用从 2025 年 4 月起必须用 GraphQL
Shopify 把 REST 管理 API 标为 legacy，新建公开应用必须走 GraphQL，老应用也开始进入迁移窗口。
发生了什么#
Shopify 在 2024 年底把 REST 管理 API 标记为 legacy（旧版），并规定从 2025 年 4 月 1 日起新建的公开应用必须使用 GraphQL 管理 API。这是 Shopify 近十年最大的一次接口范式切换：REST 仍然能用，但不再获得新功能，长期会被逐步收口。
关键细节#
- REST 管理 API 标记为 legacy，不再新增能力
- 2025 年 4 月 1 日起新建公开应用须使用 GraphQL
- 已有应用仍可调用 REST，但需评估迁移时间表
- GraphQL 采用基于查询成本的限流，与 REST 的请求数限流不同
- 批量操作（Bulk Operations）成为大批量读写的主要方式
对商家与开发者的影响#
最容易被低估的是限流模型的变化：REST 按「每秒多少请求」限制，GraphQL 按「查询成本」限制。同样的业务逻辑，写成一个重查询可能一次就被限流，拆成多个轻查询反而更顺。
对商家，短期看不到影响，但依赖 REST 的应用会逐渐落后于新功能（比如新字段、新对象只在 GraphQL 里有）。选应用时可以问一句「用的是 GraphQL 还是 REST」。
建议动作#
- 盘点现有集成用的是哪个接口，标出 REST 部分
- 迁移时优先改「读写量大、字段多」的接口
- 用 Bulk Operations 代替分页循环，减少调用次数
原文与编译说明
- 原文标题
- REST Admin API legacy and GraphQL requirement
- 发布来源
- Shopify 开发者文档
- 发布时间
- 2025-04-01
本文为中文编译摘要，包含站方补充的背景与影响分析，不是原文的逐字翻译。版权归原作者与发布方所有。若原文后续更新或信息有误，以官方页面为准；发现错误可发邮件到 admin@fgwljs.com 指出。
新闻栏目由 风格技术 技术团队维护，每个工作日筛选 Shopify 官方渠道与行业媒体的更新。功能是否可用，以店铺后台实际显示与官方文档为准。
